准备工具#

• github 账户
• git
• nodejs
• 域名(可选)

首先安装 git 和 nodejs 软件，全部点击下一步，保持默认安装即可。然后在终端中(cmd 或 powershell)输入以下命令检测安装是否成功：

1
git  -v
2
node -v
3
npm  -v

git 与 github 账户设置#

首先创建 github 账户，这里不介绍如何创建，然后安装 git 软件。 打开Git Bash，输入以下命令进行账户和邮件的配置。

1
git config --global user.name "用户名"
2
git config --global user.email "注册github的邮箱"

然后创建 ssh 密钥，用来给 hexo 程序进行上传和连接使用。

在Git Bash中输入：

1
ssh-keygen -t rsa -C "邮箱"

然后一直点击下一步知直到创建完成，打开C:\Users\用户名\.ssh目录下找到id_rsa.pub(如果没有，请打开隐藏文件显示)，然后使用记事本打开该文件并全选复制下来。

打开 github 网页，在Settings中选择SSH and GPG keys，点击New SSH key。名称自己定义一个，然后把刚刚复制的内容粘贴到Key中，保存即可。

切换到Git Bash中，输入ssh -T git@github.com检测是否连接成功。 出现以下信息表示成功：

1
You've successfully authenticated, but GitHub does not provide shell access.

创建仓库#

打开 github 网页，在自己的主页上，点击repositories然后点击New，出现创建仓库的页面。

然后在Repository name*中输入用户名加上 github.io 的后缀，例如用户名为qwer，则实际仓库名填写qwer.github.io，填好后点击Create repository即可创建完成。

然后测试是否正确，在浏览器中输入网址并访问：https://qwer.github.io,注意这里的qwer需要替换为你的用户名。 如果一切正常，将会显示用户名以及该网址和该仓库的描述信息。

hexo 本地构建网页#

在你想存放的位置创建一个文件夹用来保存 hexo 构建网页的环境，例如D:/hexo文件夹，然后打开Git Bash在此目录下。 然后安装顺序执行以下命令：

1
# 安装hexo
2
npm install -g hexo-cli
3
# 初始化hexo
4
hexo init

如果一切正常，将输出以下信息：

1
INFO  Cloning hexo-starter https://github.com/hexojs/hexo-starter.git
2
INFO  Install dependencies
3
INFO  Start blogging with Hexo!

接下来执行：

1
# 安装组件
2
npm install

如果一切正常，将输出以下信息：

1
added 1 package, and audited 227 packages in 1s
2

3
23 packages are looking for funding
4
  run `npm fund` for details
5

6
found 0 vulnerabilities

然后输入hexo g生成页面，log 如下所示：

1
INFO  Validating config
2
INFO  Start processing
3
INFO  Files loaded in 277 ms
4
INFO  Generated: archives/2024/06/index.html
5
INFO  Generated: archives/index.html
6
INFO  Generated: archives/2024/index.html
7
INFO  Generated: index.html
8
INFO  Generated: fancybox/jquery.fancybox.min.js
9
INFO  Generated: js/script.js
10
INFO  Generated: css/style.css
11
INFO  Generated: fancybox/jquery.fancybox.min.css
12
INFO  Generated: js/jquery-3.6.4.min.js
13
INFO  Generated: css/images/banner.jpg
14
INFO  Generated: 2024/06/10/hello-world/index.html
15
INFO  11 files generated in 310 ms

然后执行hexo s命令，打开浏览器输入http://localhost:4000进行预览。

链接 hexo 本地环境与 github 仓库#

上面只是在浏览器中预览本地的内容，别人无法通过网络进行访问。所以还需要将 hexo 与 github 链接到一起。 首先需要安装hexo-deployer-git插件，在上面打开的Git Bash中输入命令：

1
npm install -g hexo-deployer-git

然后修改D:\hexo\_config.yml（注意路径需要修改到你自己创建的目录），将该文件末尾的以下内容:

1
deploy:
2
  type: ""

改为如下：

1
deploy:
2
  type: git
3
  repo: git@github.com:qwer/qwer.github.io.git
4
  branch: gh-pages

然后在Git Bash中依次输入：

1
# 1. clean： 清除非必要文件
2
hexo c
3
# 2. deploy：先生成博客，然后将代码上传到github仓库中
4
hexo d -g

上传完毕后，打开浏览器，进入 github 网页，在该仓库的Settings中，点击Pages，将Branch改为gh-pages（来自上面修改的_config.yml文件）。

稍等片刻后，在浏览器中访问：https://qwer.github.io就可以访问到默认的内容。到这里就搭建好了。

但是目前只有一篇默认的文章，所以还需要说明一下如何进行创建新的文章。

以阿里云为例#

首先打开阿里云的控制台，选择云解析 DNS-域名解析-解析设置，然后选择添加记录，记录类型选择CNAME，主机记录输入自己想要定义的域名前缀。然后点击确认即可保存该记录。官方参考

这个前缀结合后面的域名共同组成了一个完整地址，hexo 中会使用该地址。

hexo 部分设置#

在本地的目录下D:\hex\source,新建一个文件叫CNAME,注意没有后缀名称。 然后输入域名(从上一小节中，添加的CNAME中的内容)。

关于草稿的使用#

1
# 新建草稿
2
hexo new draft <title>
3
# 预览本机草稿
4
hexo S --draft
5
# 发布草稿(只是将移动到post)，然后按照post去处理即可
6
hexo P <filename>
7
# 正式文章转草稿，可以直接将文章从post移动到draft即可
8

9
#  一条命令搞定：清除，生成，启动
10
hexo clean ; hexo s -g