Hexo + Butterfly 博客搭建指南（一）：本地环境配置与运行

前言

最近我用 Hexo + Butterfly 主题搭建了这个博客，整个过程虽然有些小坑，但整体还算顺利。

我打算把这个过程写成系列教程，分为三篇：

• 第一篇（本文）：本地环境配置、主题安装、插件配置、本地运行
• 第二篇：部署到 Vercel、域名配置
• 第三篇：评论系统（Waline）、统计分析、更多功能扩展

这篇文章是第一篇，主要讲解如何在本地环境把博客搭建并运行起来。希望能帮助到每一位想拥有自己独立博客的朋友。

系列文章

• 📖 Hexo + Butterfly 博客搭建指南（一）：本地环境配置与运行
• 🚀 Hexo + Butterfly 博客搭建指南（二）：部署到 Vercel
• 💬 Hexo + Butterfly 博客搭建指南（三）：评论系统与功能扩展

本文的完整版及后续更新，也可以在我的博客上查看：Hexo + Butterfly 博客搭建指南（一）：本地环境配置与运行。

环境准备

安装 Node.js

Hexo 基于 Node.js，所以需要先安装 Node.js（建议 18.x 或更高版本）。

下载地址：https://nodejs.org/

安装完成后，在终端运行：

node-vnpm-v

如果能看到版本号，说明安装成功。

安装 Hexo CLI

npminstall-ghexo-cli

初始化博客

创建博客目录

hexo init my-blog cd my-blog npm install

这会创建一个基础的 Hexo 博客项目。

本地预览

hexo server

打开浏览器访问