保姆式Hexo博客搭建教程

注：本教程在Windows下操作
我跟着自己写的教程来了一遍，应该没什么问题φ(゜▽゜*)♪

准备工作

全英文可开启浏览器自带翻译功能

遇到问题可以自行必应，或者咨询ChatGPT，不推荐百度

安装vscode

为当前用户安装一路下一步即可

安装node.js

node-v20.17.0-x64 蓝奏云备用链接

安装过程一直选下一步就行

安装Git

  • 进入Git官网：https://git-scm.com/downloads
  • 按照自己的系统选择对应的版本下载，一般选择 64-bit Git for Windows Setup 即可

安装时也是一直下一步就好

Git-2.46.0-64-bit 蓝奏云备用链接

检验是否安装成功

Win + R打开运行窗口，输入cmd，然后输入以下命令

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

那个 npm 是安装 node.js 送的

如果都有相应版本信息即安装成功，若不正确可尝试卸载软件重新安装

版本返回

Git 安装成功后，会在右键鼠标菜单里添加 Git GUI Here 和 Git Bash Here 两个选项，我们要用到的是第二个

安装 Hexo

选择一个合适的位置新建文件夹（建议使用英文名称），这个文件夹之后会被用来存放博客的所有文件，在该文件夹下右键鼠标，点击 Git Bash Here，分别运行以下几条命令安装Hexo。可能会遇到网络问题，多试几次

1
2
3
npm install hexo-cli -g
hexo init
npm install hexo-deployer-git --save

Hexo 安装完成后，将会在文件夹中生成 Hexo 相关的文件

如果你的网络环境无法使用npm，可使用cnpm代替，安装cnpm后请将命令中的npm替换为cnpm

安装cnpm(可选)

1
npm install -g cnpm --registry=https://registry.npmmirror.com

Hexo本地查看

输入以下命令

1
2
hexo g
hexo server

执行完即可访问 http://localhost:4000/ 查看效果，当你看到 Hexo 默认主题即安装成功

Hexo 默认主题

将博客部署到 Github Pages 上

部署前置步骤

注册Github账号

无法打开GitHub的可使用这两个具加速GitHub： fastgithub | 瓦特工具箱(Steam++官网) （选一个就行了）

已有账号请跳过这一步，全英文可开启浏览器自带翻译功能

  • 进入Github官网：https://github.com/

  • 点击右上角的sign up，跟随引导依次填写信息注册 GitHub 账户

配置Github账号

  • 创建项目代码库：修改名称，然后拉到底部点击一个绿色的按钮 new repository 创建仓库

new repository

  • 新建仓库名称 你的用户名.github.io

若不已这个为名称那么之后的地址就是你的用户名.github.io/仓库名称 己有域名的话仓库名称随意

配置SSH密钥

在你的博客文件夹里右键，选择 Git Bash Here，输入以下命令

1
2
ssh-keygen -t rsa -C "your email@example.com"
// 将引号里面的 your email@example.com 改为你的GitHub注册邮箱，不要删除""，粘贴时不要带上这段注释，下同

一路回车

最后输入以下命令将公钥的内容复制到粘贴板上

1
clip < ~/.ssh/id_rsa.pub

在 GitHub 账户中添加你的公钥

第一步：登陆 GitHub，点击右上角头像，进入 settings

setting位置

第二步：点击 SSH and GPG Keys，然后选择 New SSH key

SSH and GPG Keys

第三步：粘贴密钥，完成后点击 Add SSH key

New SSH key

测试

在 Git Bash，输入以下命令：

1
2
ssh -T git@github.com
//git@github.com不要更改！

然后会提示

输入yes

输入yes设置完成

配置Git个人信息

1
2
3
git config --global user.name "此处填你的用户名"
git config --global user.email "此处填你的邮箱"
// 不要删除文字外的""

到此为止 SSH Key 配置成功，你的计算机已成功连接到Github

将本地文件推送至Github的仓库中

配置Hexo的_config.yml

  • 打开仓库，选择SSH点击按钮复制
    复制SSH
  • 打开你创建的博客文件夹，用 VS Code 打开该文件夹下的 config.yml文件
    修改最下面的 Deployment 为

Deployment

1
2
3
4
deploy:
  type: git
  repository: 换为你复制的SSH
  branch: main

branch: 分支，默认 main 即可，注意缩进！

然后在 Hexo 文件夹下分别执行以下命令

1
2
3
hexo cl
hexo g
hexo d

  • 第一个命令：删除public文件夹下生成的文件

  • 第二个命令：生成文件

  • 第三个命令：上传文件

至此你的博客搭建完成

访问博客：https://你的用户名.github.io

额外（可选择项）

绑定域名

  • 在域名服务商处新增CNAME解析，记录值为你的用户名.github.io

接着在GitHub pages添加你的域名

github pages

在博客 source 文件夹下新建文本文档，将名称改为CNAME

CNAME

保存，然后移除后缀.txt，注意这个文件没有后缀

如果你的电脑不显示.txt后缀请自行搜索如可显示文件扩展名

此操作是为了避免推送时将GitHub生成的CNAME文件删除

将博客文件备份至Github

为了防止你的电脑把你的文件都扬了，这里建议备份至Github

博客根目录打开，切换到vscode的git面板，选择初始化仓库
vscode git面板打开

初始化仓库后先点击加号暂存所有更改，然后起一个提交名称（这个随意），最后点击提交按钮
提交代码

提交后发布分支，起个名字，选择私人（private）仓库，如果你的vscode没有登录Github，他可能会让你登录，按步登录即可
发布分支

发布后会自动开始第一次推送，推送完成提示信息就可以去Github查看你的备份代码了
提交完成

Hexo 自带了配置好的 .gitignore，会将无关文件排除，如果你有其他文件要排除，自行添加即可，这里不过多赘述，自行bing

在博客上发表文章

新建一个空文章

输入以下命令，会在 [blog]/source/_post 中生成 文章标题.md 文件，文章标题根据需要命名

1
hexo n 文章标题

发表文章

还是执行

1
2
3
hexo cl
hexo g
hexo d

当然在在推送前你可以使用 hexo server 预览一下

注：编写文章使用 Markdown语言，具体语法和教程可自行搜索，这里不过多赘述

安装主题

hexo主题安装
推荐安装Solitude主题，这是他的文档，或者你有其他自己想装的主题，参考其文档即可