手把手带你飞！Hexo + 安知鱼主题，从零搭建美美哒个人博客 ✨

蔚什么？2025-03-272025-03-27

好嘞，各位未来的博客大神们，请坐好扶稳！🚀 今天我要带你们坐上 Hexo 的小火箭，直奔酷炫博客的星辰大海，而且还要给它穿上“安知鱼（Anzhiyu）”这件超靓的外衣！准备好了吗？ Let’s Go！

标题：手把手带你飞！Hexo + 安知鱼主题，从零搭建美美哒个人博客 ✨

你是不是也曾幻想过拥有一个属于自己的、看起来贼专业、贼酷炫的博客？可以随心所欲地分享你的技术心得、生活感悟，或者只是晒晒猫？🐱

但是一想到要搞服务器、数据库、复杂的后台… 就头皮发麻？🤯

别怕！今天的主角 Hexo 就是你的救星！它是一个快速、简洁、高效的博客框架，能把你的 Markdown 文件“biu”的一下变成漂亮的静态网页。而 安知鱼（Anzhiyu） 主题，则是我个人（以及很多小伙伴）超爱的一款高颜值、功能丰富的 Hexo 主题！

强强联合，让你的博客梦轻松起飞！下面，就跟着我的脚步，一步步来操作吧！

第一步：打地基！安装必备环境 (Node.js 和 Git)

盖楼得先有地基和工具，对吧？搭建 Hexo 博客也一样。我们需要两个好兄弟：

Node.js: Hexo 是基于 Node.js 的，所以这是必须的“动力引擎”。
Git: 主要用来后续部署博客到 GitHub Pages 等平台，以及安装主题有时也需要它。

怎么装？
- 访问 Node.js 官网，下载推荐的 LTS (长期支持) 版本，像安装普通软件一样下一步下一步就好啦。
- 访问 Git 官网，下载并安装。一路默认选项通常没问题。
检查一下装好了没？
打开你的终端（Windows 用户推荐使用 Git Bash，或者 Windows Terminal；macOS/Linux 用户用自带的终端就行），输入以下命令：
1
2
3
node -v
npm -v
git --version
如果都能看到版本号输出，那就说明你成功召唤了这两位大神！🎉

第二步：请 Hexo 大佬出山！(安装 Hexo CLI)

有了环境，我们就可以请出 Hexo 的“总指挥”—— Hexo 命令行工具 (CLI) 了。

在终端里输入：

1	npm install hexo-cli -g

-g 的意思是“全局安装”，这样你在任何地方都能使用 hexo 命令了。稍等片刻，看到进度条跑完就 OK！

第三步：开工！创建你的博客项目

选一个你喜欢的地方（比如 D 盘的 myblog 文件夹，或者桌面？别放 C 盘系统目录就好），在终端里 cd 进去。然后，激动人心的时刻到了：

1
2
3

hexo init my-awesome-blog  # 把 'my-awesome-blog' 换成你喜欢的文件夹名字
cd my-awesome-blog         # 进入你的博客文件夹
npm install                # 安装项目依赖，这一步很重要！

Hexo 会自动帮你生成一堆文件和文件夹，这就是你博客的“骨架”。现在你的博客文件夹看起来大概是这样：

.
├── _config.yml      # 核心配置文件！超重要！
├── package.json
├── scaffolds        # 文章模板
├── source           # 你的文章、页面都放这里！
|  ├── _drafts
|  └── _posts       # 你的文章 Markdown 文件所在地
└── themes           # 主题文件夹！一会儿安知鱼就住这儿

先跑起来看看？

在你的博客文件夹（my-awesome-blog）里，运行：

1	hexo server # 或者简写 hexo s

终端会告诉你博客运行在 http://localhost:4000。在浏览器里打开这个地址，你应该能看到一个默认主题的 Hexo 博客！按 Ctrl+C 可以停止本地预览。

第四步：给博客换新衣！安装安知鱼主题 🎣

默认主题有点朴素？没关系，我们要请“安知鱼”登场了！

回到你的博客文件夹的终端里，使用 Git 克隆主题：

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

这行命令的意思是：把安知鱼主题的代码，下载到你博客的 themes 文件夹下，并命名为 anzhiyu。

第五步：告诉 Hexo，你要用新衣服！

光下载了还不行，得告诉 Hexo：“喂，我要穿 anzhiyu 这件！”

打开你博客根目录下的 _config.yml 文件（注意！不是 themes/anzhiyu 里面的那个！），找到 theme: 这一行，把它改成：

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: anzhiyu  # 把这里改成 anzhiyu

保存文件！

第六步：精装修！配置安知鱼主题 🛠️

安知鱼主题功能超多，所以它有自己专属的配置文件。强烈建议不要直接修改 themes/anzhiyu/_config.yml！因为主题更新时会覆盖你的修改。

正确的做法是：

在你的博客根目录（和 _config.yml 同级）下，创建一个新的文件，命名为 _config.anzhiyu.yml。
将 themes/anzhiyu/_config.yml 里的所有内容复制到你新建的 _config.anzhiyu.yml 文件里。
以后所有关于安知鱼主题的配置，都在根目录的 _config.anzhiyu.yml 里修改！

现在，打开根目录的 _config.anzhiyu.yml，你可以开始定制你的博客了！比如：

修改 menu（导航菜单）
配置 social（社交链接）
开启或关闭各种功能（评论、搜索、代码高亮样式等）

这个文件里的注释写得很详细，耐心看看，根据自己的需要修改。改完记得保存！

重要提示： 每次修改完 Hexo 的 _config.yml 或主题的 _config.anzhiyu.yml 后，最好重新运行 hexo server 才能看到效果！有时为了确保配置生效，可以先按 Ctrl+C 停掉服务，然后运行 hexo clean && hexo server（清除缓存再启动）。

第七步：发布上线！部署到 GitHub Pages (免费大法好！)

本地预览看着不错了？该让全世界看到你的博客了！这里我们用最流行、免费的 GitHub Pages 来部署。

创建 GitHub 仓库:
- 登录你的 GitHub 账号。
- 创建一个新的公开仓库 (public repository)。
- 仓库名必须是 你的GitHub用户名.github.io （比如我的用户名是 cool-coder，仓库名就是 cool-coder.github.io）。这是 GitHub Pages 的规定！
安装部署插件:
回到你的博客项目终端，安装 hexo-deployer-git 插件：
1
npm install hexo-deployer-git --save

配置部署信息:
再次打开你博客根目录的 _config.yml 文件，拉到最下面，找到 deploy: 部分，修改成这样：

deploy:
  type: git
  repo: https://github.com/你的GitHub用户名/你的GitHub用户名.github.io.git  # 换成你自己的仓库地址！
  branch: main  # 或者 master，取决于你仓库的默认分支是啥

repo: 就是你刚才创建的那个 .github.io 仓库的 HTTPS 地址。
branch: 通常是 main 或 master，去你 GitHub 仓库看看默认分支叫啥就填啥。

保存文件！

一键部署！🚀
在终端里，运行这套“三连”命令：

    hexo clean && hexo generate && hexo deploy
    ```    *   `hexo clean`: 清除旧的生成文件和缓存。
    *   `hexo generate` (或 `hexo g`): 生成静态网页文件（放到 `public` 目录下）。
    *   `hexo deploy` (或 `hexo d`): 把 `public` 目录下的文件推送到你配置好的 GitHub 仓库。

    第一次部署时，可能需要你输入 GitHub 的用户名和密码（或者 Personal Access Token，如果开启了 2FA）。

    等命令跑完，没有报错的话，稍等几分钟（GitHub Pages 需要一点时间生效），然后访问 `https://你的GitHub用户名.github.io`，就能看到你崭新的、由 Hexo 和安知鱼驱动的博客啦！

---

**第八步：开始你的创作吧！✍️**

部署成功了？太棒了！现在你可以开始写文章了。

```bash
hexo new post "我的第一篇博客文章"