安知鱼主题配置

gaoxiruo2026-01-072026-01-08

搭建 Hexo 博客
如果你还没有 Hexo 博客，请按照 Hexo 官方文档进行安装、建站。

主题安装

方式一(Github 推荐):

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

如遇安装不上可以使用以下url代理安装

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

方式二(Release 推荐):

下载最新 release 版本解压到 themes 目录，并将解压出的文件夹重命名为 anzhiyu。

方式三(npm安装):

1	npm i hexo-theme-anzhiyu

此方法只支持 Hexo 5.0.0 以上版本通过 npm 安装并不会在 themes 里生成主题文件夹，而是在 node_modules 里生成

测试版Dev

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

测试版可能存在 bug，追求稳定的请安装稳定版

应用主题

打开 Hexo 根目录下的 config.yml, 找到以下配置项，把主题改为anzhiyu

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: anzhiyu

安装 pug 和 stylus 渲染插件

1	npm install hexo-renderer-pug hexo-renderer-stylus --save

无法安装可以使用cnpm进行安装

1	npm install hexo-renderer-pug hexo-renderer-stylus --save --registry=http://registry.npmmirror.com

覆盖配置

覆盖配置可以使主题配置放置在 anzhiyu 目录之外，避免在更新主题时丢失自定义的配置。

通过 Npm 安装主题的用户可忽略，其他用户建议学习使用。

macos/linux 在博客根目录运行

1	cp -rf ./themes/anzhiyu/_config.yml ./_config.anzhiyu.yml

windows 复制/themes/anzhiyu/_config.yml此文件到 hexo 根目录，并重命名为_config.anzhiyu.yml

以后如果修改任何主题配置，都只需修改 _config.anzhiyu.yml 的配置即可。

注意：

只要存在于 _config.anzhiyu.yml 的配置都是高优先级，修改原 _config.yml 是无效的。
每次更新主题可能存在配置变更，请注意更新说明，可能需要手动对 _config.anzhiyu.yml 同步修改。
想查看覆盖配置有没有生效，可以通过 hexo g --debug 查看命令行输出。
如果想将某些配置覆盖为空，注意不要把主键删掉，不然是无法覆盖的

本地启动 hexo

1
2
3

hexo cl
hexo g
hexo s

此时就能在看到效果了。

升级方法

方式一

适用于通过 Github 或 Release 压缩包主题，且没有自行修改任何代码的情况。
先将原文件夹重命名为别的名称，例如 anzhiyu-bkp，用于升级失败进行回退；
选择自己的安装方式升级

Github：重新重新执行安装命令即可

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

Release：按照安装步骤，下载 release 并解压重命名为 anzhiyu；

比对升级后的配置文件_config.yml，如果某些配置发生了变化（改名或弃用），release 的说明里会特别提示或给出配置文件版本对比diff，同步修改原配置文件即可。

方式二

适用于通过 Npm 安装主题。
在博客目录下执行命令：

1	npm update --save hexo-theme-anzhiyu

比对升级后的配置文件_config.yml,如果某些配置发生了变化（改名或弃用），release 的说明里会特别提示或给出配置文件版本对比diff，同步修改原配置文件即可。

方式三

全量更新：删除theme/anzhiyu文件夹，然后重新执行安装命令即可。