🚀 环境准备

前置要求
在开始之前，请确保系统已安装以下依赖环境：

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

1. 安装 Node.js

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

2. 准备 Hexo

本项目使用项目本地依赖，不安装全局 Hexo CLI。创建新项目时使用临时 CLI：

pnpm dlx hexo-cli init
Hexo官方文档

📁 项目初始化

3. 创建项目目录

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

4. 初始化 Hexo 项目

在新项目根目录执行：

pnpm install

🎨 安装 Butterfly 主题

5. 安装 Butterfly 主题

主题作为项目依赖安装，不在 themes/ 目录维护源码：

pnpm add hexo-theme-butterfly

⚙️ 配置主题

6. 配置文件设置

重要步骤

  1. 在根目录维护 _config.butterfly.yml，不要修改 node_modules 中的主题文件
  2. 确认根目录 _config.yml 的 theme 字段为 butterfly

7. 修改主题配置

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

theme: butterfly

🎯 启动博客

8. 清理并生成

pnpm clean
pnpm build

9. 启动本地服务器

pnpm dev

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

📋 命令总结

清理缓存 生成静态文件 部署到服务器 启动本地服务
完整命令列表
pnpm check
pnpm check:production
pnpm clean
pnpm build
pnpm dev
pnpm run deploy

小贴士

  • 使用 _config.butterfly.yml 管理主题配置，主题升级不会覆盖站点配置
  • 使用 pnpm exec hexo new "文章标题" 创建新文章
  • 发布前先执行 pnpm check:production、pnpm clean 和 pnpm build