Butterfly 是国内 Hexo 圈子里最有名的博客主题，没有之一。GitHub 8400+ Star，很多你刷到过的个人技术博客，用的就是它。
它不是独立程序，是 Hexo 的皮肤——你得先有 Hexo 博客，再把 Butterfly 套上去。所以这次实测我没只装主题，而是从零搭了一整套能跑的博客：主题、配置、导航菜单、搜索、暗色模式、示例文章全部配好，你们拿到压缩包解压双击就能跑，省去自己折腾配置的环节。
先给结论：颜值和功能对得起它的名气，但它是「技术人的方向盘」——你得接受用命令行和配置文件来开车。
它到底好在哪里
官方的宣传词是「卡片式设计」，翻译成人话就是：白底圆角卡片、大图封面、层次清楚，看起来不累。
实测下来让我印象比较深的有这些：
- 首页 banner 渐变大图 + 打字机效果
- 文章封面卡片左右交错排列（可选 7 种布局）
- 文章页右侧自动生成目录，滚动高亮
- 代码块自带语言标注、复制按钮、行号
- 本地搜索（不用第三方服务，纯本地索引）
- 一键切深色模式，选择会被记住
- 移动端适配到位，手机上看体验很完整
这次实测是怎么搭的
- 环境：Windows 11 本地 + Node.js 22
- Hexo：7.x（博客框架）
- Butterfly：v5.7.0（Apache-2.0 协议）
- 站点内容：3 篇示例文章 + 1 个关于页
整个搭建流程是这样的：先建 Hexo 站点骨架 → 安装核心依赖 → 把 Butterfly 主题放进 themes 目录 → 改站点配置和主题配置 → 写示例文章 → 跑起来。每一步都留了截图。
部署：装好 Node 后，双击一个文件就行
Hexo 是 Node 程序，所以第一步是装 Node.js（官网或国内镜像都有安装包，下一步下一步就行）。
装完 Node 之后，剩下的事就简单了——我打包时把依赖库全部内置了，双击 启动博客.bat，浏览器自动打开 http://localhost:4000，博客就跑起来了。
首页顶部就是品牌区：logo、导航、渐变 banner、打字机副标题。这个打字机的三句话是随机循环打的，我截了完整一句的状态。
首页和文章列表
往下滚是文章列表，封面和文字左右交错，这个布局在只有两三篇文章的时候也不显得空：
右侧边栏是我配好的四张卡片：作者卡（头像 + 「访问官网」按钮）、公告卡、最新文章、分类标签。作者卡下面那两个小图标是社交入口，点一下直接跳源码湾官网。
页脚是统计信息 + 版权，可以自己改文案。
文章页：目录、代码块、表格
点开一篇文章，顶部是文章头图和信息区（发布日期、更新时间、分类）：
正文右侧有个悬浮目录，滚动时当前章节会自动高亮，长文党的刚需：
代码块的效果值得单独说：左上角标语言（BASH）、右上角一键复制、行号完整，配色也舒服：
表格样式也是现成的，直接用 Markdown 表格语法就行。
分类、标签、归档、关于页
这四个是博客的标配页面，Butterfly 都有现成的版式：
归档页按年份分组，标签页用不同颜色的标签块区分。都不需要自己写页面，加几行配置就出来了。
深色模式
点击右下角齿轮图标 → 太阳/月亮按钮切换：
这个深色模式不是简单粗暴地反色——banner 图会蒙一层暗色滤镜，卡片、文字、代码块的高亮主题全都跟着变，切换后你的选择会存在浏览器里，下次打开还是深色。
本地搜索
点导航栏的放大镜，弹窗里输入关键词，结果是本地索引出来的（不经过任何第三方服务）：
我搜「Typecho」，3 篇文章里相关内容都有命中，有标题有摘要。这个搜索的索引文件是生成时自动建的，你发新文章后重新生成一次就会更新。
手机端
375px 宽的手机模拟下来：
顶部导航收起成「搜索 + 汉堡菜单」，点汉堡弹出侧栏抽屉（头像、统计、五个导航项）：
排版没有横向溢出，字体大小也合适，属于「真的做过了」的移动端，不是敷衍的缩放。
说缺点（重要）
夸完了，该说缺点了。这些都是我自己用下来真实感受到的：
1. 门槛比 PHP 程序高。 Typecho 那种程序，传上服务器浏览器里点几下就装完了。Butterfly 必须先有 Node 环境，对完全没碰过命令行的朋友来说，「装 Node」这一步就能卡住一半人。我虽然把依赖内置了，但你电脑上至少得有 Node 才能跑。
2. 主题配置项多到吓人。 themes/butterfly/_config.yml 有 1100 多行，第一次打开这个文件是懵的。好在官方文档写得很细，但改配置还是得像查字典一样对着看。改错了整个页面报错是常有的事——建议改之前先备份一份。
3. 默认依赖海外 CDN 加载资源。 主题的图标、部分脚本默认走 jsdelivr（海外 CDN），国内访问大部分时候正常，但偶尔会抽风导致图标加载不出来。官方支持把 CDN 源改成 local（本地加载），需要自己在配置里改一下。
4. 升级主题要小心。 因为主题配置就放在主题文件夹里，以后升级 Butterfly 到新版本、替换 themes 文件夹时，你之前的自定义配置会被覆盖。升级前记得把 _config.yml 备份出来。
适合谁
怎么拿到
本文实测用的完整包（主题 + 配好的站点 + 3 篇示例文章 + 内置依赖，解压双击就能跑）：
两个小提醒：
- 建议先「转存到自己网盘」再下载——直接下载的链接容易失效，转存后就是你自己的了，随时能下；
- 手机上操作：点开链接 → 右下角「保存到网盘」→ 回夸克 App 的「我的网盘」里下载。
装之前先确认两件事：Node 18 以上、一个能跑的 Hexo 站点。主题本身零依赖，但要它跑起来，引擎和文章得先有。
自己动手的成本：主题配置一千一百多行，上面记的那几个改动点，你自己对着改一遍也得小半天。包里是我改完、跑通之后的样子，拿来对照比自己摸快得多。
包里我还放了一份源码包（Apache-2.0 协议），想自己从零研究的可以对照着看。
