跳转到主要内容

6 有把握地交付

用一套可重复的发布清单,依次检查本地预览、生产构建、主题升级与线上部署。

文档站点的交付通常包含四个阶段:本地预览、锁定或升级主题模块、执行干净的生产构建,以及推送到托管平台上线。 按顺序检查每个阶段,能在构建或部署出错时快速定位原因。

按阶段检查发布流程

阶段 已验证的内容 仍需继续确认的事项
本地预览 页面、导航与内容修改可在 hugo server 中正常渲染 生产环境 baseURL、草稿过滤与干净的模块状态
主题模块版本 hugo mod graph 在 go.mod 与 go.sum 中解析到目标公开标签 站点内容与覆盖项能否在该版本下通过生产构建
生产构建 内容、配置与 go.mod 在 --environment production 下构建通过 托管平台工作流、CDN 缓存与线上公开路由
线上部署 CI 工作流成功完成,主要公开路由均可正常访问 代表性页面在桌面端与窄屏下的实际排版表现
表 6-1 从本地预览到线上部署的四个验证阶段,以及各阶段留给下一步确认的事项。

验证最小且有效的范围

在自己的 Starter 仓库中,先执行一次干净的生产构建,再触发部署工作流:

hugo --cleanDestinationDir --gc --minify --environment production \
  --printPathWarnings

确认 hugo mod graph 解析到 go.mod 中预期的公开版本,再按Starter 部署步骤操作。 普通 Starter 站点不需要 npm 构建脚本或同级主题目录。如果同时在修改 OINK 主题本身, 可按主题开发流程进行联调。

审阅真正渲染出的结果

自动检查能发现坏链接、重复 ID、无效短代码与无障碍回归,而版面与可读性仍需肉眼审阅。 请在桌面与窄屏宽度下抽查具有代表性的中英文页面,涵盖 Hero 裁切、宽表格、导航、主题切换控件、 代码块以及整书打印视图。

整理发布记录

发起 Pull Request 或升级主题版本时,对照 表 6-1 记录当前使用的 Hugo 版本、go.mod 中的主题版本、构建输出以及抽查过的页面路由。 在变更说明中附上这份简短清单,方便团队审阅与回滚排查。

完整的运维参考见预览站点、 部署站点与排查构建问题。