🌟 什么是 Hexo？

Hexo 是一个快速、简洁且高效的博客框架，基于 Node.js 开发。它使用 Markdown 语法来编写文章，能够快速生成静态网页，并且可以轻松部署到 GitHub Pages、Cloudflare Pages 等免费平台。

📋 事前准备

在开始搭建博客前，我们需要准备以下几项：

• ✅ 域名（非必须，可以使用免费域名，或者 GitHub.io 或 Pages.dev 分配的域名）
• ✅ GitHub 账号（必须，需要注册一个 GitHub 帐号用于托管博客）
• ⭕ Cloudflare 账号（非必须，可以用于 CDN 加速，也可以直接使用 GitHub.io 分配的域名）

💻 软件支持

进行 Hexo 博客搭建，我们需要以下软件：

🟢 安装 Node.js

1. 前往 Node.js 官网 下载与系统相匹配的安装程序
2. 安装时使用默认目录 C:/Program Files/nodejs/
3. 安装完成后，验证安装：按 Win+R 打开 CMD 窗口，执行以下命令：

1
2

node -v
npm -v

4. 修改 npm 源以加快下载速度：

1

npm config set registry https://mirrors.huaweicloud.com/repository/npm/

🟠 安装 Git

1. 前往 Git 官网 下载适合当前系统的版本
2. 按默认设置安装，推荐使用默认目录 C:/Program Files/Git
3. 安装完成后，可以在开始菜单找到以下三个程序：
   • Git CMD：Windows 命令行风格
   • Git Bash：Linux 系统命令风格（推荐使用）
   • Git GUI：图形界面（不建议新手使用）

🔑 配置 Git 密钥并连接至 GitHub

👤 配置用户名和邮箱

打开 Git Bash（从开始菜单或右键菜单中选择），输入以下命令配置用户名和邮箱：

1
2

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

🔐 配置公钥连接 GitHub

第一步：生成 SSH 密钥

在 Git Bash 中生成 SSH 密钥：

1

ssh-keygen -t rsa -C "你的邮箱"

按三次回车即可生成密钥（默认保存位置、无密码保护）

第二步：查看公钥

在 Git Bash 中查看公钥：

1

cat ~/.ssh/id_rsa.pub

或在 Windows 资源管理器中打开文件 C:\Users\你的用户名\.ssh\id_rsa.pub

第三步：添加公钥到 GitHub

复制公钥内容，登录 GitHub 网站，进入 Settings → SSH and GPG keys → New SSH key，将公钥粘贴进去，点击 Add SSH key

第四步：验证连接

在 Git Bash 中验证连接：

1

ssh -T git@github.com

如果是首次连接，会出现以下提示：

1
2
3

The authenticity of host 'github.com (20.205.243.166)' can't be established.
ECDSA key fingerprint is SHA256:p2QAMXNIC1TJYWeIOttrVc98/R1BUFWu3/LiyKgUfQM.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

输入 yes 并按回车继续。随后如果看到类似以下信息：

1

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

则表示 SSH 连接验证成功！

📁 创建 GitHub.io 仓库

1. 在浏览器中登录 GitHub，点击右上角 “+”，选择 “New repository”
2. 仓库名称必须为 用户名.github.io（例如：username.github.io）
3. 选择 Public 可见性，不需要添加 README 文件
4. 点击 “Create repository” 完成创建

🚀 初始化 Hexo 博客

现在开始正式搭建我们的博客！

📦 安装 Hexo

第一步：安装 Hexo

全局安装 Hexo 命令行工具：

1

npm install -g hexo-cli

第二步：初始化博客

创建博客目录并初始化：

1
2
3
4

mkdir blog
cd blog
hexo init
npm install

第三步：安装部署插件

安装 Git 部署插件：

1

npm install hexo-deployer-git --save

⚙️ 配置 Hexo

1. 使用 VSCode 或任何文本编辑器打开博客根目录下的 _config.yml 文件
2. 找到 deploy 部分并修改为：

1
2
3
4

deploy:
  type: git
  repo: git@github.com:你的用户名/你的用户名.github.io.git
  branch: main

👀 本地预览博客

在博客根目录下执行以下命令：

1
2
3
4
5
6
7
8
9

# 生成静态文件
hexo generate
# 或简写为
hexo g

# 启动本地服务器
hexo server
# 或简写为
hexo s

然后在浏览器访问 http://localhost:4000 查看效果！

🌐 部署到 GitHub Pages

📤 部署博客

在博客根目录下执行以下命令：

1
2
3
4
5
6
7
8
9
10
11
12
13

# 清理缓存
hexo clean

# 生成静态文件
hexo generate

# 部署到 GitHub
hexo deploy
# 或简写为
hexo d

# 也可以一键生成并部署
hexo g -d

🎯 访问你的博客

部署完成后，等待几分钟，然后访问 https://你的用户名.github.io 查看你的博客！

☁️ 部署到 Cloudflare Pages（可选）

除了 GitHub Pages，你还可以将博客部署到 Cloudflare Pages，这样可以获得更好的访问速度和更多的功能。

1. 在浏览器中注册并登录 Cloudflare 账号
2. 在 Cloudflare 控制面板中，点击 “Pages”
3. 点击 “Create a project”，选择 “Connect to Git”
4. 授权并选择你的 GitHub 仓库
5. 配置构建设置：
   • 项目名称：自定义（如 my-blog）
   • 生产分支：main（或你的默认分支名）
   • 构建命令：npm run build 或 hexo generate
   • 构建输出目录：public
6. 点击 “Save and Deploy” 开始部署
7. 部署完成后，Cloudflare 会提供一个 *.pages.dev 域名访问你的博客

📝 如何使用 Hexo

✍️ 新建一篇博文

在博客根目录下执行以下命令创建一篇新文章：

1

hexo new "文章标题"

这会在 source/_posts 目录下创建一个新的 Markdown 文件，可以使用 VSCode 或其他编辑器打开编辑。

👀 本地预览

编辑完文章后，执行以下命令在本地预览效果：

1
2
3
4
5
6
7
8

# 清理缓存
hexo clean

# 生成静态文件
hexo g

# 启动本地服务器
hexo s

然后在浏览器访问 http://localhost:4000 查看效果。

🚀 发布文章

确认无误后，执行以下命令将本地文章推送至 GitHub 仓库：

1
2
3
4
5
6
7
8

# 清理缓存
hexo clean

# 一键生成并部署
hexo g -d

# 或者分步执行
hexo generate --deploy

🛠️ 常见问题解决

❌ VSCode 终端首次执行报错

如果在 VSCode 终端中执行 Hexo 命令时出现错误，可能是因为 PowerShell 的执行策略限制。

解决方案：

1. 以管理员身份运行 PowerShell（在开始菜单中右键点击 PowerShell，选择”以管理员身份运行”）
2. 执行以下命令：

1

Set-ExecutionPolicy RemoteSigned

3. 输入 “Y” 确认更改
4. 重新打开 VSCode 尝试执行 Hexo 命令

📋 常用 Hexo 命令汇总

以下所有命令都需要在博客根目录下的终端中执行：

1
2
3
4
5

# 新建文章
hexo new "文章标题"

# 新建页面
hexo new page "页面名称"

1
2
3
4
5
6
7
8
9
10

# 生成静态文件
hexo generate
hexo g

# 启动本地服务器
hexo server
hexo s

# 清理缓存
hexo clean

1
2
3
4
5
6

# 部署到远程
hexo deploy
hexo d

# 一键生成并部署
hexo g -d

1
2
3
4
5

# 查看版本
hexo version

# 查看帮助
hexo help

💡 实用技巧

🗂️ 自动生成目录页面

为了让博客更加完整，你可能需要创建分类页面、标签页面和关于页面：

1
2
3

hexo new page categories
hexo new page tags
hexo new page about

然后分别编辑这些页面的 Markdown 文件，添加相应的 Front Matter 配置。

🔗 添加文章永久链接

为了让你的文章链接更加稳定，可以安装永久链接插件：

1

npm install hexo-abbrlink --save

然后在 _config.yml 中修改永久链接设置：

1
2
3
4

permalink: posts/:abbrlink/
abbrlink:
  alg: crc32
  rep: hex

🔍 添加本地搜索功能

安装搜索插件：

1

npm install hexo-generator-searchdb --save

然后在 _config.yml 中添加配置：

1
2
3
4
5

search:
  path: search.xml
  field: post
  content: true
  format: html

⚠️ 注意事项

🎉 总结

通过本教程，我们完成了基于 Hexo 框架的个人博客搭建。从环境配置、初始化到部署，每一步都有详细的说明。我们还介绍了如何将博客部署到 GitHub Pages 和 Cloudflare Pages，以及一些常见问题的解决方法和实用技巧。

在下一篇文章中，我们将介绍如何安装和配置美观的 AnZhiYu 主题，让你的博客更加个性化和美观。