保姆式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 相关的文件

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文件删除

在博客上发表文章

新建一个空文章

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

1
hexo n 文章标题

发表文章

还是执行

1
2
3
hexo cl
hexo g
hexo d

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

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

安装主题

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