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 ...