在github pages中用hexo搭建属于你自己的网站(保姆级)

xuanmou 发布于 2025-10-21 48 次阅读


(此文章默认读者已经拥有github账户,能够魔法上网,并做好git的相关配置)

一、配置必要的部署环境

1.安装npm

进入nodejs下载网站Node.js — 下载 Node.js®后下拉,点击“独立文件”按钮

将压缩包解压后进入解压了的文件

记住他的路径,图示的路径为C:\Users\xuanmou\Downloads\node-v22.20.0-win-x64\node-v22.20.0-win-x64\

我们回到桌面,右键此电脑,点击属性进入系统设置界面

点击高级系统设置

点击环境变量

在系统变量中找到Path后点击编辑,然后点击新建,将你解压好的nodejs路径丢进去就好了

我们可以在键盘上按Win+R键打开运行,输入cmd回车打开终端

输入npm -v可观察自己是否成功安装

(如图,见到这样或者类似的画面就代表你成功安装了)

2.安装hexo

依旧打开cmd,输入下面的命令

npm install hexo-cli -g

(如下载遇到困难之类的,建议魔法上网或者寻找npm国内镜像源进行替换,本文章将不多阐述)

如果提示npm版本过低的,可以尝试先使用这个命令

npm install -g npm

二、配置hexo

我们在桌面或者随便一个位置新建一个文件夹,名字就叫awa就好了

点进去右键->在终端中打开

输入下列命令来创建一个hexo项目,名字为qwq

hexo init qwq
cd qwq
npm install

得到的文件如下

其中_config.yml是配置文件,其配置项目可参考官网配置 | Hexo

(文件中中文注释是需要特别注意的地方)

在 source\post\ 下是你的文章存放的位置

三、部署到github pages

我们登录到github

新建一个仓库

注意:这里仓库名字命名有讲究,仓库名必须得是<你自己的名字>.github.io

比如我GitHub账号叫xuanmou,所以我应该命名一个叫作xuanmou.github.io的仓库

在创建好了仓库之后

复制你仓库的git地址,比如我的是https://github.com/xuanmou/xuanmou.github.io.git

随后在配置文件找到这个

替换为

deploy:
  type: git
  repo: https://github.com/xuanmou/xuanmou.github.io.git #换成你自己的
  branch: main
  message: qwq

保存

在项目位置打开终端输入

npm install hexo-deployer-git --save
hexo d

等待数秒 浏览器打开<你的github名字>.github.io就好了

比如我的是这个

这样一个属于自己的网站就做好了