Hexo + Butterfly 博客故障排查完全指南：如何解决文章页面为空的疑难杂症
🚨 问题现象昨天我的博客突然出现了问题：文章页面显示为空白，从首页点击文章链接后，页面内容完全为空。 具体表现： 首页文章列表正常显示 点击文章标题进入详情页 文章页面返回 HTTP 200，但 content-length: 0 本地 hexo generate 生成的 public/文章路径/index.html 文件大小为 0 字节 🔍 诊断过程第一步：检查本地生成文件123cd blog-sourcels -la public/2026/02/11/hello-world/# 输出：-rw-rw-r-- 1 admin admin 0 Feb 11 18:14 index.html 发现：本地生成的文件大小为 0 字节！说明问题出在生成阶段，而不是部署阶段。 第二步：查看构建日志1hexo generate --debug 2>&1 | grep -E "(ERROR|WARN|TypeError)" 发现关键错误： 12ERROR TypeError: Cannot read property 'wordcoun...
Hexo + Butterfly + GitHub Pages 快速搭建个人博客
一、教程说明 适用人群：新手 / 技术博主，无需复杂编程基础，按步骤即可完成 最终效果：免费、稳定、高颜值的个人博客（支持暗黑模式、评论、搜索、统计等） 技术栈：GitHub Pages（免费托管）+ Hexo（静态博客框架）+ Butterfly（主题）+ Waline（评论） 预计耗时：30 分钟（全程复制粘贴操作） 二、前期准备2.1 必备工具 GitHub 账号：注册地址 https://github.com Node.js：下载地址 https://nodejs.org/（选择 LTS 版，自动安装 npm） Git：下载地址 https://git-scm.com/（版本控制工具，部署用） 文本编辑器：推荐 VS Code（https://code.visualstudio.com/），方便编辑配置文件 2.2 环境验证安装完成后，打开终端（Windows：cmd/PowerShell；Mac/Linux：终端），执行以下命令，显示版本号即成功： 123node -v # 示例输出：v20.10.0npm -v ...