1. 安装 Git#

Git 是一个免费的开源分布式版本控制系统。我们后续需要使用 Git 克隆 Butterfly 仓库，所以要先安装 Git。 访问 Git Scm 自行下载并安装 Git。

2. 安装 Bun#

Bun 是一款快速的 JavaScript 一体化工具包。它最大的特点就是快，而且与 Node.js 兼容性也算好。所有这里我们就不用传统的 Node.js 搭建博客了。

Bun 的安装十分简单，一行命令就能完成。对于 Linux 和 MacOS，使用如下命令安装：

1
curl -fsSL https://bun.sh/install | bash

对于 Windows，在 Powershell 中用如下命令安装：

1
powershell -c "irm bun.sh/install.ps1 | iex"

在Linux 和 MacOS 环境安装后，可能需要配置下环境变量，这里就不再赘述了。

接下来测试下 Bun 是否成功安装：

1
bun -v

如果能正常输出版本号，则说明安装成功。

3. 安装 Hexo#

光有了 JavaScript 运行环境还不够，我们这里还需要 hexo-cli 脚手架。可以使用如下命令安装 Hexo:

1
# bun install 与 bun add 一样，官方默认推荐使用 bun add。-g 参数则是全局安装。
2
bun add hexo-cli -g

安装完成后我们就可以开始了。

4. 创建默认 Hexo 博客#

我们可以使用 hexo init 创建一个新的 hexo 博客项目：

1
# 这里的 blog 是你的博客项目名称
2
hexo init my-blog

安装完成后进入创建的博客目录：

1
cd my-blog

所需要的依赖在 hexo init 的时候就已经安装了，我们这里可以先开启本地服务器看一下博客页面：

1
# hexo server 和它等效
2
hexo s

如果没什么问题访问 http://localhost:4000 应该是如下图，正常显示：

这个默认样式太丑了，接下来我们给它加上 Butterfly 主题。

5. 添加 Butterfly 主题#

Butterfly 主题非常漂亮，当然你也可以选择其他主题。更多主题详见 Hexo Themes。

我们使用之前安装的 Git 克隆 Butterfly 仓库：

1
# -b 指定仓库分支， --depth=1 参数的意思是只需要最新的 commit（这样克隆速度快）
2
git clone -b master --depth=1 https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

克隆完成后我们需要应用主题。使用 hexo config theme 进行修改。

1
# 配置 Hexo 主题为 Butterfly
2
hexo config theme butterfly

修改完成后，我们需要安装 pug 和 stylus 渲染器（这是因为 Butterfly 主题基于这两个渲染器）

1
# 安装 pug 和 stylus 渲染器
2
bun add hexo-renderer-pug hexo-renderer-stylus

还没有完，我们需要根目录下有一个主题配置文件。但是好消息是我们克隆的 Butterfly 仓库已经包含了这个配置文件。我们只需要将它复制到博客项目根目录即可。

打开 themes/butterfly 目录，重命名 _config.yml 为 _config.butterfly.yml。复制重命名后的 _config.butterfly.yml 到 博客项目根目录。

复制完成后删除原本的 themes/butterfly/_config.butterfly.yml。

来测试下主题是否成功应用。同样的：

1
hexo s

然后访问 http://localhost:4000 查看主题是否成功应用：

6. 修改配置#

主题应用成功后，我们需要修改配置文件。主题配置和根配置文件都需要修改（也就是 config.butterfly.yml 和 _config.yml）。配置修改完成后我们可以本地预览，心怡之后我们就可以正式开始部署了。

7. 部署到 Github Pages#

首先我们要先修改根配置文件。打开 _config.yml 找到 deploy，将：

1
deploy:
2
  type: ''

改为：

1
deploy:
2
  type: 'git'
3
  repo: 'https://github.com/你的用户名/你的用户名.github.io.git'

保存并退出文件，安装 Git 部署所需要的库：

1
bun add hexo-deployer-git

完成后记得先在 Github 中创建一个仓库，仓库名叫 你的用户名.github.io。完成之后使用以下命令进行 Github Pages 一键部署：

1
# hexo deploy 与它等效
2
hexo d

这时候会让你登录你的 Github 账户，就正常登录授权即可。完成之后等待两分钟（为了等 Github Pages 部署完毕），访问 https://你的用户名.github.io 查看部署是否成功。若无异常，恭喜你成功部署了自己的个人主页（所有人都可以访问）