🚀 环境准备

前置要求
在开始之前，请确保你的系统已经安装了以下环境：

  • Node.js (建议使用最新LTS版本)
  • Git
  • 一个代码编辑器 (推荐 VS Code)

1. 安装 Node.js

需要提前安装 Node.js，并自行配置环境变量。如果使用 PowerShell 可能需要输入 npm.cmd，本教程采用的是 bash 环境。

2. 安装 Hexo

使用以下命令全局安装 Hexo CLI：

1
npm install -g hexo-cli
Hexo官方文档

📁 项目初始化

3. 创建项目目录

创建一个英文名称的文件夹，并在其中打开终端（PowerShell、CMD、Bash 任选其一）

4. 初始化 Hexo 项目

在项目根目录执行：

1
hexo init

🎨 安装 Butterfly 主题

5. 下载主题源码

1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
1
git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

开发版可能包含未测试的新功能，建议新手使用稳定版

Butterfly主题源码

6. 安装主题依赖

1
npm i hexo-theme-butterfly

⚙️ 配置主题

7. 配置文件设置

重要步骤

  1. 将 themes/butterfly/_config.yml 复制到根目录
  2. 重命名为 _config.butterfly.yml
  3. 修改根目录的 _config.yml 文件中的 theme 字段为 butterfly

8. 修改主题配置

在根目录的 _config.yml 文件中找到 theme 字段，修改为：

1
theme: butterfly

🎯 启动博客

9. 清理并生成

1
2
hexo clean
hexo generate

10. 启动本地服务器

1
hexo server

🎉 恭喜！
你的 Hexo 博客已经搭建完成！在浏览器中访问控制台提供的链接（通常是 http://localhost:4000），Ctrl + 鼠标左键点击即可访问你的博客。

📋 命令总结

清理缓存 生成静态文件 部署到服务器 启动本地服务
完整命令列表
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 清理缓存和已生成的文件
hexo clean

# 生成静态文件
hexo generate
# 或简写
hexo g

# 启动本地服务器
hexo server
# 或简写
hexo s

# 部署到远程服务器
hexo deploy
# 或简写
hexo d

# 生成并部署
hexo g -d