Butterfly主题博客之搭建教程
Hexo+Github搭建博客教程
一、环境准备
1.Node.js安装
Node.js是Hexo的运行环境,必须先安装。
默认选项安装,一路点击“确认”
win+R输入cmd,打开命令提示符验证安装:
1
2#检查 Node.js 版本
node -v返回版本信息则代表安装成功!

然后进行npm换源,运行:
1 | npm config set registry https://registry.npmmirror.com |
无报错则安装完成!
2.Git安装
下载Git:Git - Install
选择[Git for Windows/x64 Setup]
安装时选择默认选项,一路选择回车
验证安装:
1 | git --version |
出现版本号则说明安装成功!
3.安装Hexo
在Windows搜索栏中搜索“Git Bash”,打开。
输入以下指令:
1
npm install -g hexo-cli
安装之后,运行下面指令:
1
hexo -v
验证是否安装成功,当出现版本号则说明安装成功!
4.GitHub部署
在GitHub官网注册一个账号
注册后创建仓库,仓库名必须为:<用户名>.github.io
Git Bash 运行
1
2git config --global user.name <你的用户名>
git config --global user.email <你的邮箱>运行以下代码检查是否配置成功
1
git config -l

当出现user.name和user.email与之前输入的相同时,则配置成功!
5.连接至GitHub
运行:
1 | ssh-keygen -t rsa -C <你的邮箱> |
按三次回车生成ssh密钥,用于连接到GitHub
之后打开C盘用户文件夹下的.ssh的文件夹,用记事本打开 id_rsa.pub,复制里面的内容。
然后点击GitHub账户头像 > Settings > SSH and GPG keys > New SSH key
Title随意,Key粘贴刚刚复制的密钥,之后点Add SSH key
运行以下代码测试连接,出现连接到账户至此环境部署完成
1 | ssh -T git@github.com |

说明连接成功!
二、新建Hexo项目
在想要创建的文件夹下,右键,Open Git Bash here,运行
1 | hexo init 项目名 |
安装依赖:
1 | npm i |
三、配置Hexo
推荐使用VS code 进行编辑
安装后使用VScode打开项目文件夹,点击查看>终端,运行下面指令:
1 | hexo cl; hexo g; hexo s |
CTRL+C 可结束运行,浏览器打开 http://localhost:4000/ 测试网站
四、安装主题
这里使用的是Butterfly主题
如果你沒有 pug 以及 stylus 的渲染器,请先下载安装:
1
npm install hexo-renderer-pug hexo-renderer-stylus --save
下载butterfly主题到项目文件夹下
1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
可能出现的问题:
fatal: unable to access ‘https://github.com/.../.git‘: Recv failure Connection was rese
解决办法:
在终端输入以下命令,设置 Git 使用本地代理:
1 | git config --global http.proxy http://127.0.0.1:7890 |
7890是梯子的代理端口号。
设置完成后,可以通过以下命令检验是否设置成功:
1 | git config --global -l |
五、托管到GitHub
安装 hexo-deployer-git
1 | npm install hexo-deployer-git --save |
修改 _config.yml 文件 deploy 部分
1 | deploy: |
修改好配置后记得 CTRL+S 保存,运行以下命令,将代码部署到 GitHub
1 | hexo cl; hexo g; hexo d |
如果出现 Deploy done,则说明部署成功!



