Hexo 工程化配置与发布指南

环境与仓库基线

先统一 Node.js、包管理器和 Git 身份，再验证 Hexo CLI。国内网络环境需要明确 npm registry，但不应关闭 TLS 校验。仓库初始化后先完成本地 clean、generate、server 闭环。

结构与配置

文章统一进入 source/_posts，站点名称、作者、语言、时区、URL 和 permalink 在根配置中明确。主题配置与主题源码分离，可以减少升级时的冲突。

发布链路

GitHub Pages 适合静态产物托管；源码仓库和 Pages 产物仓库分离后，历史更清晰，回滚也更容易。发布前固定执行清理和完整构建，避免旧缓存混入线上结果。

常见故障

命令不存在通常来自 PATH 或 CLI 未安装；SSH 失败先验证密钥；主题不生效先确认配置名称并清理缓存；部署无更新则检查仓库地址和目标分支。工程化的关键是让问题有稳定的排查顺序。