前言

作为一个刚入门的新手站长，我曾满怀期待地用 Typecho 和免费虚拟主机搭建博客。然而，免费服务商跑路的经历让我感到无奈。最终，我选择了更加稳定的方案——Hexo 博客 + Anzhiyu 主题，并通过 GitHub + Cloudflare Pages 实现了免费托管。

搭建 Hexo 博客并不简单，尤其是对小白来说：教程五花八门，电脑配置各不相同，报错频频。一路上，我花了大半个月时间不断尝试和解决问题，终于成功完成了自己的 Hexo 博客搭建！为帮助更多新手少走弯路，我整理了这篇详细教程，用浅显易懂的方式带大家轻松入门。本文内容全部都是详细内容，不会一笔带过任何细节，有些地方可以选择跳读。

🧰 准备材料

注：注册过程简单，按网站指引操作即可，全程免费

一、安装必备工具

1. 安装 Git

Git 是 Hexo 的必备工具，用于管理文件和版本控制，可以帮助你。安装步骤如下：

• 前往 Git 官网的下载页面 下载适合你操作系统的版本。
• windows用户下载这里 点击橙色文字————Git for Windows/x64 Setup
• macOS用户下载这里 参考 这篇文章 进行下载
• Linux用户下载这里 参考 这篇文章 进行下载
• 安装时选择默认选项即可，无需额外更改设置。
• 如果你想学习 Git 的基本操作，参考 这篇文章 进行学习。
  安装时保持默认选项，连续点击”Next”

验证安装是否成功：
打开命令行（Windows 的 CMD 或 macOS/Linux 的终端），输入以下命令：

1

git --version

注：如果安装成功，会显示 Git 的版本信息

如果安装失败
1. 检查电脑是否安装了 Git
如果电脑上没有安装 Git，需要先安装 Git。

2. 检查安装路径
确保 Git 安装在默认路径，即 C:\Program Files\Git 或 C:\Program Files (x86)\Git 或 /usr/bin/git。
如果使用的是自定义安装路径，需要确保 Git 安装在自定义路径下。
打开这些路径，检查是否存在 Git 相关文件。

3. 检查环境变量
检查 PATH 环境变量是否包含 Git 安装路径。
Windows 7：

1. 右键点击“计算机”，选择“属性”。
2. 点击左侧的“高级系统设置”。
3. 在弹出的窗口中，点击“环境变量”按钮。
4. 在“系统变量”部分，找到并双击Path变量。
5. 查看Path变量是否包含Git的安装路径。
6. 如果没有包含，在Path变量中的最后面打一个分号，然后粘贴“C:\Git的安装路径\bin”。
7. 点击“确定”保存即可。

Windows 10：

1. 右键点击“计算机”，选择“属性”。
2. 点击左侧的“高级系统设置”。
3. 在弹出的窗口中，点击“环境变量”按钮。
4. 在“系统变量”部分，找到并双击Path变量。
5. 查看Path变量是否包含Git的安装路径。
6. 如果没有包含，在Path变量里点击“新建”，然后粘贴Git的安装路径。
7. 点击“确定”保存即可。

4. 重新安装 Git

如果以上方法都没有解决问题，建议重新安装 Git。
也可以自行百度或者询问相关专业人士寻求帮助。

2. 安装 Node.js

Hexo 需要依赖 Node.js 运行环境。安装步骤如下：

• 前往 Node.js 官网的下载页面 下载适合你操作系统的版本，点击“Windows 安装程序(.msi)”。
• 安装时记得勾选 Add to PATH 选项（确保命令行可以调用 Node.js），其它选择默认选项即可，无需额外更改设置。
• 安装完成后，验证 Node.js 是否安装成功。

3. 检查 Node.js 版本
输入以下命令检查 Node.js 版本：

1
2

node -v
npm -v

注：如果安装成功，会显示 Node.js 和 npm 的版本信息

如果安装失败
1. 检查电脑是否安装了 Node.js
如果电脑上没有安装 Node.js，需要先安装 Node.js。

2. 检查安装路径
确保 Node.js 安装在默认路径，即 C:\Program Files\Node.js 或 C:\Program Files (x86)\Node.js 或 /usr/bin/node。
如果使用的是自定义安装路径，需要确保 Node.js 安装在自定义路径下。
打开这些路径，检查是否存在 Node.js 相关文件。

3. 检查环境变量
检查 PATH 环境变量是否包含 Node.js 安装路径。
Windows 7：

1. 右键点击“计算机”，选择“属性”。
2. 点击左侧的“高级系统设置”。
3. 在弹出的窗口中，点击“环境变量”按钮。
4. 在“系统变量”部分，找到并双击Path变量。
5. 查看Path变量是否包含Node.js的安装路径。
6. 如果没有包含，在Path变量中的最后面打一个分号，然后粘贴“C:\Node.js的安装路径\bin”。
7. 点击“确定”保存即可。

Windows 10：

1. 右键点击“计算机”，选择“属性”。
2. 点击左侧的“高级系统设置”。
3. 在弹出的窗口中，点击“环境变量”按钮。
4. 在“系统变量”部分，找到并双击Path变量。
5. 查看Path变量是否包含Node.js的安装路径。
6. 如果没有包含，在Path变量里点击“新建”，然后粘贴Node.js的安装路径。
7. 点击“确定”保存即可。

4. 重新安装 Node.js

如果以上方法都没有解决问题，建议重新安装 Node.js。
也可以自行百度或者询问相关专业人士寻求帮助。

二、安装 Hexo

1. 安装 Hexo
在命令行中运行以下命令全局安装 Hexo：

1

npm install -g hexo-cli

在命令行中运行以下命令检验安装是否成功：

1

hexo -v

注：如果安装成功，会显示 Hexo 的版本信息

如果并没有显示 Hexo 的版本信息
应该是你使用了官网的局部安装方法（）
你可以尝试使用 npx hexo -v进行确认
如果使用以上命令会显示 Hexo 的版本信息，说明安装成功,但是使用的是局部安装，不是全局安装，所以后面的 hexo 命令需要使用 npx hexo😟。

2. 初始化 Hexo 博客
打开文件管理器，选择一个文件夹作为你的博客存储位置（如 D:/Hexo 或 ~/Hexo），进入目录，然后再在上面地址栏输入cmd，按下回车，打开命令行窗口，然后运行以下命令：

1
2
3
4

hexo init blog
cd blog
npm install
npm install hexo-deployer-git --save

这会生成一个名为 blog 的文件夹，里面包含 Hexo 所需的所有文件，然后安装自动部署发布工具。

三、配置 Anzhiyu 主题

Hexo 默认主题较为简陋，而 Anzhiyu 主题 功能丰富、美观大方，非常适合新手使用。
1. 下载 Anzhiyu 主题
在 Hexo 博客目录下运行以下命令，克隆 Anzhiyu 主题到 themes 文件夹：

1

git clone https://github.com/anzhiyu-c/hexo-theme-anzhiyu themes/anzhiyu

2. 配置主题
打开 Hexo 主配置文件 _config.yml，找到 theme 项，将其修改为 anzhiyu：

1

theme: anzhiyu

3. 安装主题依赖
进入主题目录并安装相关依赖包：

1
2

cd themes/anzhiyu
npm install

四、上传到 GitHub

1. 创建 GitHub 仓库

• 登录 GitHub，点击右上角的 “+” 号，选择 New repository（新建仓库）。
• 在 Repository name（仓库名称）一栏输入任意名字（如 my-blog），选择 Public（公开），无需勾选其他选项。
• 然后再点击绿色按钮 Create repository（创建仓库）。
  2. 上传博客
• 点击Create repository（创建仓库）之后，Github会跳转至新创建的仓库页面，即github/你的用户名/仓库名。
• 点击页面中间的 Code 按钮，弹出的框中点击 HTTPS 选项，会有一个HTTPS开头的网址，右边有一个复制按钮，点击复制按钮，复制仓库的 HTTPS 地址。
• 回到 Hexo 目录，即那个刚刚创建的blog文件夹，里面有一个叫 _config.yml 的文件，打开文件，下滑到最下面，找到 deploy 配置项，按如下格式修改：

1
2
3
4

deploy:
  type: git
  repo: 复制的 HTTPS 地址
  branch: main

• 保存并关闭文件。
• 打开命令提示符，输入以下命令配置一下 Git ：

1
2

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

• 然后要配置一下 SSH秘钥:

1. 打开命令提示符，输入以下命令生成 SSH 密钥：

1

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

2. 然后敲4次Enter⌨️
3. 打开C盘，然后点击用户文件夹，点击你的用户名文件夹（一般是Administrator），找到 .ssh 文件夹，打开文件夹，会有 id_rsa 和 id_rsa.pub 两个文件，复制 id_rsa.pub 文件中的内容。
4. 登录 GitHub，点击右上角头像 -> Settings -> SSH and GPG keys -> New SSH key，Title 随便填，将 id_rsa.pub 文件中的内容粘贴到 Key 字段中，点击 Add SSH key 按钮。
5. 输入一下命令，测试一下（如果开了类似Steam++的加速器，把加速器关掉）：

1

ssh -T [email protected]

回车，然后输入yes
如果显示 Hi 你的用户名! You've successfully authenticated, but GitHub does not provide shell access. 说明配置成功了。

• 上传博客
  输入一下命令，生成博客并上传博客：

1
2

hexo g  #生成博客
hexo d  #上传博客

做完这些，博客就上传成功了。

五、上传至Cloudflare Pages

1. 打开并登录Cloudflare
2. 点击 计算（Workers） -> Workers 和 Pages -> 创建 -> Pages
3. 点击 导入现有 Git 存储库 的开始使用 按钮
4. 选择 Github
5. 点击 添加账户 登录自己的Github账号
6. 完成后，选择自己的账号，然后选择自己刚刚创建的仓库，点击 完成设置
7. 项目名称选自己喜欢的，因为这个可能是你的博客地址（除非你有其它域名），大概就是如果你的项目名称是blog，那么你的博客地址就是 blog.pages.dev，然后其它什么也不用改，往下滑，点击蓝色字体 环境变量（高级），点击 添加变量，变量名称为 NODE_VERSION，变量值为 你自己的Nodejs版本号（如：22.14.0）
   小提示：Nodejs版本号可以在命令提示符中输入 node -v 查看。
8. 做完这一切，点击蓝色按钮 保存并部署

现在，你的博客就正式上线了。

下面是对博客的更新教程：

六、博客基本信息

打开博客目录（\blog），博客基本信息在 _config.yml 文件中，你可以根据需要修改。
一般情况下，只需要修改 # Site 下的信息，比如标题、描述、作者、语言等。

1
2
3
4
5
6
7
8

## Site
title: 标题
subtitle: 副标题
description: 描述
keywords: 关键词(易于被搜索引擎搜索到)
author: 作者（即站长你）
language: 语言（可以填zh-CN）
timezone: 时区（可以填Asia/Shanghai）

然后还有 # Url 也可以修改:

1
2

## URL
url: https://你的域名.pages.dev

七、博客主题修改

首先，为了防止更新主题把博客主题信息覆盖，所以需要先来到主题目录：
也就是打开博客目录（\blog）,然后依次点击 themes -> anzhiyu
然后将 _config.yml 文件改名为 _config.anzhiyu.yml，然后 Ctrl+C/V 复制粘贴到博客目录（\blog）下，然后回去主题目录把文件名改回 _config.yml
然后来到博客目录（\blog），打开 _config.anzhiyu.yml ，可以进行主题配置修改。
这里建议：每完成一次小更改就要进行一次生成，以免在我们不知不觉中产生报错，尤其影响博客的正常运行
关于 _config.anzhiyu.yml 文件的修改，可以直接参照 官方文档
每完成一次小更改，就比如你现在写了一个404页面，然后 hexo g 生成博客，结果报错了，那你就可以立即找出错误是在404页面上，而不是一下子做大工程，结果还要返回来逐一排查，非常影响效率。
报错情况：
执行命令：

1

hexo g

如果出现红色字符就是报错了。
自己通过官方文档配置，主题配置不多阐述。

八、博客编写

编写有两种，一种是编写文章，一种是编写页面

1. 编写文章：

1

hexo new post 文章标题

2. 编写页面：

1

hexo new page 页面标题

整体使用 Markdown 语法，关于 Markdown 语法可以参考 Markdown 语法或者从网上其它地方获取帮助和学习

到这里本篇博客教程就已经草草结束了，感谢阅读。
新手站长写博客文章，可能会有一些错误，欢迎指正。
许多地方，包括教程顺序都有点乱，我会在以后抽空作出调整。
以下列出所有参考资料：

1. Hexo官方文档
2. Anzhiyu官方文档
3. Fiveth大佬的《如何用Hexo搭建个人博客?》
4. 廖雪峰的《Git教程》
   感谢这些参考资料，如果参考资料的作者有对此篇文章的被参考内容有侵犯到，请联系我，我会删除侵权内容。