说明：本文初版写于 2026 年 3 月，2026 年 10 月修订。本期使用基于 hexo-theme-butterfly 修改的安知鱼主题（简洁美观的 Hexo 静态主题）演示博客美化。
1. 安装主题
1.1 Git 安装
在博客根目录执行，安装最新版主题：
1
| git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu
|
首次使用需要安装 pug 和 stylus 渲染器：
1
| npm install hexo-renderer-pug hexo-renderer-stylus --save
|
1.2 应用主题
修改 Hexo 主配置文件 _config.yml，把主题改为 anzhiyu：
1.3 覆盖配置
把主题配置放到 anzhiyu 目录之外，避免更新主题时丢失自定义配置。
1
| cp -rf./themes/anzhiyu/_config.yml./_config.anzhiyu.yml
|
- Windows：手动把
/themes/anzhiyu/_config.yml 复制到博客根目录，重命名为 _config.anzhiyu.yml。
之后修改任何主题配置，只改 _config.anzhiyu.yml 即可。注意：
- 只要
_config.anzhiyu.yml 里存在的配置都是高优先级，改原 _config.yml 无效；
- 每次更新主题可能有配置变更，注意看更新说明，必要时手动同步
_config.anzhiyu.yml；
- 想确认覆盖配置是否生效，可用
hexo g --debug 查看命令行输出；
- 如果想把某项配置覆盖为空，不要删掉主键，否则无法覆盖。
1.4 本地预览与发布
1
2
3
4
5
|
hexo clean && hexo server
hexo clean && hexo generate && hexo deploy
|
1.5 生成标签页和分类页
生成标签页：
找到 source/tags/index.md，添加 type: "tags"：
1
2
3
4
5
6
7
| ---
title: 标签
date: 2024-07-05 03:36:02
type: "tags"
comments: false
top_img: false
---
|
生成分类页：
1
| hexo new page categories
|
找到 source/categories/index.md，添加 type: "categories"：
1
2
3
4
5
6
7
| ---
title: 分类
date: 2024-07-05 03:36:48
aside: false
top_img: false
type: "categories"
---
|
剩下的工作就是按需修改 _config.yml 和 _config.anzhiyu.yml，调整博客参数。
2. 配置文章模板
scaffolds 目录下有几个模板文件：
post.md：新建博文模板；page.md：新建页面模板。
post.md 模板（仅供参考）
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
| ---
title: {{ title}}
date: {{ date}}
updated:
tags:
categories:
keywords:
description:
top:
top_img:
comments:
cover:
toc:
toc_number:
copyright:
copyright_author:
highlight_shrink:
aside:
swiper_index: 10
top_group_index: 10
ai:
background: "#fff"
---
|
page.md 模板（仅供参考）
1
2
3
4
5
6
7
8
9
10
11
| ---
title: {{ title}}
date: {{ date}}
type:
updated:
comments:
description:
keywords:
top_img:
aside:
---
|
3. 更多功能
新建文章与页面
1
2
| hexo new "这是一篇新的博文"
hexo new page "页面名称"
|
文章置顶
- 安装插件：
1
| npm install hexo-generator-topindex --save
|
- 给需要置顶的文章添加
top 参数，数字越大越靠前：
1
2
3
4
5
6
7
8
9
| ---
title: 每天一个 Linux 命令
date: 2017-01-23 11:41:48
top: 1
categories:
- 运维
tags:
- Linux命令
---
|
开启本地搜索
- 安装插件：
1
| npm install hexo-generator-search --save
|
- 在主题配置文件中开启：
1
2
3
4
| local_search:
enable: true
preload: false
CDN:
|
| 参数 |
说明 |
| enable |
是否开启本地搜索 |
| preload |
预加载；开启后进入网页自动加载搜索文件，关闭则点击搜索按钮后才加载 |
| CDN |
搜索文件的 CDN 地址（默认使用本地链接） |
在网站根目录添加任意文件
例如申请 AdSense 时需要在网站根目录放置 ads.txt 验证文件，只需把 ads.txt 放到 /source 文件夹下，部署后它就会出现在网站根目录。
参考资料
🎬 YouTube：https://www.youtube.com/@DECODING-w7d
👥 官方群组：https://t.me/+tVg48WK48tlkNGVl
📣 官方网站：http://smjmgx.dpdns.org/
