网上好多教程都是 Windows 环境下的， 那我就做一篇macOS环境下的吧。

不能说很像，但是事实就是很像，又水一篇。

Butterfly主题的诞生离不开Jerry，本网站即使用Hexo框架以及Butterfly主题构建。

开始之前

注意
本文中的部分命令的执行及网站访问可能需要特定的网络环境。如果你在中国大陆地区，可能会出现速度缓慢甚至无法访问的情况，进而出现Error。
你可以使用科学上网解决该问题。
你需要的是耐心，细心，完善网站是一个漫长的过程。

环境部署

安装 git

使用 Homebrew 进行安装

如果你未安装过Homebrew，请在终端使用该命令安装：

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

完成后，直接在终端中输入：

1
brew install git

安装Node.js

在其官网上下载macOS版本并安装。

Node.js

检查安装是否完成

1
2
3
node -v
npm -v
git -v

若能出现版本号即安装成功。

Hexo部署

安装位置

选择你喜欢的位置放置新建一个文件夹用于你的所有blog文件。路径最好不要存在中文或其他雷普的符号。

接下来，在终端中定位到此目录：

1
2
cd <指定的博客目录>
# 例如 cd /users/rin/blogfile

提示
你可以直接将文件夹拖放到终端中来定位。

安装Hexo并且初始化

在终端中直接输入：

1
2
3
4
5
sudo npm install -g hexo-cli
hexo init
hexo install
hexo g
hexo s

此时打开浏览器并访问localhost:4000，如果出现hexo的初始界面即表明hexo已经部署成功。

提示
若要停止本地服务器，请在终端中按 Control+C

Butterfly主题配置

安装

在终端中执行：

1
2
3
4
# 克隆Butterfly仓库
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
# 安装 pug 以及 stylus 的渲染器
sudo npm install hexo-renderer-pug hexo-renderer-stylus --save

应用主题

使用Nano或VS Code打开hexo根目录下的_config.yml，修改其中的主题配置：

1
theme: butterfly

后续配置

请参考：
Butterfly官方文档

部署博客至Github

新建仓库

新建一个仓库，注意名字必须是[username].github.io

配置SSH keys

在终端中执行：

1
ssh-keygen -t rsa -C "你的邮箱地址"

前往/users/username/.ssh，打开id_rsa.pub,复制其中全部内容。

登录github，在Settings中找到SSH keys并添加刚才复制的key。

在终端中执行检查绑定情况：

1
ssh -T git@github.com

出现Successfully即绑定成功。

上传blog

1
2
sudo npm install hexo-deployer-git --save # 安装 hexo-deployer-git
hexo d

中间会出现一个登录界面，可以用令牌登录。

2023-12-24 更新
若出现Spawn failed at ChildProcess错误，可以参考此解决方案
关于在macOS上部署hexo到github时出现Spawn-failed-at-ChildProcess报错的解决方案

等待部署，过程大约30-60s。

这时打开[username].github.io，即可访问你的博客。

后续

所有文章均使用 Markdown 编写

因此，学习它是很重要的。

Markdown

配置_config.yml

用来个性化你的博客。

访问Hexo官方文档，Butterfly官方文档以及Github进行学习

从入门到 入土 完善。

附：

Hexo官方文档

Butterfly官方文档

其他：Terminal Command Cheat Sheet

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 安装依赖
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install git
brew install node@22
# 检查安装是否完成
node -v
npm -v
git -v
# 定位目录
cd <指定的博客目录>
# 安装Hexo并且初始化
sudo npm install -g hexo-cli
hexo init
hexo install
hexo g
hexo s
# 克隆Butterfly仓库
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
# 安装 pug 以及 stylus 的渲染器
sudo npm install hexo-renderer-pug hexo-renderer-stylus --save
# 配置ssh keys
ssh-keygen -t rsa -C "你的邮箱地址"
ssh -T git@github.com
# 上传blog
sudo npm install hexo-deployer-git --save
hexo d