本教程参考安知鱼的主题，详见 文档 | anzhiyu

Hexo

Hexo 是搭建博客的一个框架，相当于我们身上的骨头骨架。有了骨架，博客才有载体呈现。

Hexo 是一个快速、简洁且高效的博客框架。 Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

有任何问题，详见 文档 | Hexo。

建议所有命令都在 vscode 中运行，简单方便 ！

检查环境

打开 vscode 或其他相关软件，运行

1
2
3
4
hexo --version
node --version
npm --version
git --version

会显示相应的软件版本。如没有安装相关软件，自行下载。

💻node. js

安装 node. Js

💻git

安装git

初始化 hexo 项目

选择一个磁盘，新建一个文件夹“BLOG”(文件名随意)。博客的相关文件，会储存在此文件夹下。打开 vscode，在当前文件夹“BLOG”运行（或在该文件夹里右键鼠标，点击 “Git Bash Here”，运行）

1
hexo init

不要在相同位置运行几个 hexo 项目，会报错！


当看到 start blogging with Hexo! ，即为成功。

💻安装主题

安装基于“butterfly ”修改的主题—— anzhiyu 主题。运行

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

因为要连接 github，所以时间可能会稍长一点，耐心等待！如果没有执行成功，再运行一次命令。

启用主题

修改根目录下的 _config.yml，把主题 landscape 改为 anzhiyu

1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: anzhiyu

更改语言

修改根目录下的 _config.yml，把 language 的 en 更改为 zh-CN

1
2
language: zh-CN
timezone: ''

配置优先级主题

复制 /themes/anzhiyu/_config.yml 副本，重命名为 _config.anzhiyu.yml，移动此文件到 Hexo 根目录，并使主题文件 _config.anzhiyu.yml 中的配置优先级大于自带主题文件 _config.yml。

💻安装 pug 和 stylus 渲染插件

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

本地启动 Hexo

1
2
3
hexo cl
hexo g
hexo s

以上命令可以一起复制，一起执行。

点击 http://localhost:4000，就可以预览，按 Ctrl+C 停止预览。