Hexo + Butterfly 从零开始搭建个人博客（三）

有些效果无法在这儿体现，如果想看完整的效果，请移步个人站点。

原文链接：基于 Hexo 从零开始搭建个人博客（三）

阅读本篇前，请确保已经完成下面两篇文章的步骤：

基于 Hexo 从零开始搭建个人博客（一）

基于 Hexo 从零开始搭建个人博客（二）

前言

博客搭建过程遇到任何问题，优先在本页面搜索，检查是否已经有该配置教程。遇到问题可以优先在文章评论区留言，注意留言时请填写正确的邮箱以确保能收到站长的回复。实在解决不了的问题可添加站长 Wechat ，添加好友时请备注自己的姓名+专业，如 张三 计算机科学与技术。

安装主题

本站基于Hexo搭建，用的 🦋 hexo-theme-butterfly 主题 v3.7.1，请注意最新的🦋 hexo-theme-butterfly 版本已经更新到 v4.2.2 。

如果你是 v3.7.1 之外的版本，可能有些地方会有出入，请留意。

本人用的是npm方式安装的hexo-theme-butterfly，后续魔改时更改的文件都是【G:/hexo-blog/blog-demo/node_modules/hexo-theme-butterfly】文件夹中的文件。如果你是git clone克隆方式安装的主题，请在【G:/hexo-blog/blog-demo/themes/butterfly】文件夹下修改对应的文件。

npm安装（推荐

此方法只支持 Hexo 5.0.0以上版本

在你的博客根目录（我这里路径为【G:/hexo-blog/blog-demo】）打开cmd命令窗口执行`npm i hexo-theme-butterfly@3.7.1`。

npm i hexo-theme-butterfly@3.7.1

安装成功后可在【G:/hexo-blog/blog-demo/node_modules】文件夹下找到hexo-theme-butterfly。

升级方法：在博客根目录下，运行npm update hexo-theme-butterfly。

升级前请将hexo-theme-butterfly文件夹备份，npm更新会直接覆盖成新的包。

Git安装 (Github)

在你的博客根目录里（我这里路径为【G:/hexo-blog/blog-demo】），打开Git工具，执行命令即可。

git clone -b 3.7.1 /jerryc127/hexo-theme-butterfly.git themes/butterfly

安装成功后可在【G:/hexo-blog/blog-demo/themes】文件夹下找到butterfly，可以将landscape文件夹删掉。

升级方法：在主题目录下，运行git pull

Git安装 (Gitee)

在你的博客根目录里【我这里路径为【G:/hexo-blog/blog-demo】），打开Git工具，执行命令即可。

git clone -b 3.7.1 /iamjerryw/hexo-theme-butterfly.git themes/butterfly

升级方法：在主题目录下，运行git pull

应用主题

修改站点配置文件_config.yml，把主题改为butterfly

theme: butterfly

安装插件

如果你没有pug以及stylus的渲染器，请下载安装：

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

升级建议

为了减少升级主题后带来的不便，请使用以下方法（建议，可以不做）。

把主题文件夹中的_config.yml复制到 Hexo 根目录里，同时重新命名为_config.butterfly.yml。

以后只需要在_config.butterfly.yml进行配置就行。

Hexo会自动合併主题中的_config.yml和_config.butterfly.yml里的配置，如果存在同名配置，会使用_config.butterfly.yml的配置，其优先度较高。