一、问题背景最近在更换 Hexo 主题时,从 Stellar 切换到 Butterfly,来回修改配置、切换分支、更换主题文件,导致博客出现各种报错: 页面空白、白屏 index.html 生成 0KB 空文件 Pug / EJS 模板渲染失败 本地正常、线上不更新 Git 分支混乱(master / main / gh-pages) 双主题共存导致环境彻底崩溃 经过一步步排查,最终成功恢复正常,并总结了一套最安全的双主题管理方案。 二、出现的典型错误 页面空白,浏览器什么都不显示→ public 文件夹生成空文件,模板渲染失败 Pug 模板报错 Cannot read properties of undefined (reading ‘path’) 主题冲突报错 切换 GitHub Pages 分支后不生效本地部署成功,但线上依旧旧页面 / 空白页 三、完整修复步骤(最有效)1. 彻底清理环境(解决空白页核心)12345hexo cleanrm -rf publicrm -rf node_modules package-lock.jsonrm -rf .depl ...