如何做发布前的检查

用途：在按下发布之前，逐项确认该准备的都准备了。这是一道闸门，不是一份流程。

覆盖：站点发布、文件上线、批量部署之前的自查。

产出：通过，或者「卡在第几项」。没有第三种结果。

拿到就能跑：逐项过，任一项不过就停。带着一项没过发布出去，出问题时你会同时处理两件事。

触发的变异问法

• 「可以发布了吗」
• 「上线前要检查什么」
• 「推之前还有什么要注意的」
• 「这次改动安不安全」
• 「能不能直接推」
• 「发布前清单有没有」
• 「怎么避免上线出事故」
• 「紧急修复也要走这套吗」

什么时候不要用这份文件

• 已经在发布过程中 —— 这是闸门，闸门在开门前用。
• 改的是服务器配置或数据 —— 那不是文件发布，检查项不同。
• 只是想看看线上长什么样 —— 那是查看，不是发布。
• 发布内容还没定稿 —— 先定稿，再检查。检查不负责发现「还没想好」。

检查项

一 · 改动范围清不清楚

判据：能列出这次要动的每一个文件，以及每个文件为什么动。 不过怎么办：停下，先列清单。说不出「为什么动」的文件，不要推——它多半是顺手带上的。

二 · 有没有回退点

判据：改动前的线上文件已备份，且备份件 md5 等于改动前那一版。 不过怎么办：先建回退点，再继续。判据是内容不是时间——按时间挑「最新备份」，可能挑到的正是被覆盖过的新内容。

三 · 有没有别的任务在跑

判据：没有相关进程、没有锁文件、目标目录最近没有其它写入。 不过怎么办：等它结束再推。两边同时写同一个索引，最后谁赢取决于毫秒，输的一方静默消失，而且事后极难发现。

四 · 线上当前是什么版本

判据：取回来的 md5 与你预期的一致（线上确实还是旧版）。 不过怎么办：查清是谁推过、推了什么。线上已经是新版还照推一遍，可能把别人的改动盖掉。

五 · 有没有顺带带上的东西

判据：待推清单里没有临时文件、调试代码、密钥、本地配置、日志。 不过怎么办：逐个剔除。⛔ 不要用通配符推——别人的临时文件可能就在同一个目录里，一起被带走。

六 · 派生件会不会受影响

判据：清楚这次改动会让哪些索引、清单、缓存需要重建。 不过怎么办：先想清楚再推。推完才发现索引是旧的，等于「内容在，但找不到」。

七 · 回退路径走过没有

判据：能说清怎么退、退哪些文件、退完怎么验证。 不过怎么办：没走过就先写下来。紧急时没有人会现场想这个——那时只会更慌。

八 · 推完怎么知道成功

判据：有明确的四项验证——状态码、字节数、md5、关键文字。 不过怎么办：没有验证方法，就不算可发布。「推上去了」和「生效了」是两件事。

输出规范

人读

检查结果：通过 / 不通过（卡在第 N 项）
各项：1 ✓ 2 ✓ 3 ✗（有任务在跑，等到 15:40）4 …
未覆盖：<这次检查没管什么，例如「没查内容质量」>

机器读

verdict: pass | fail
blocked_at: <项编号>|null
items: [{n, name, ok: true|false, evidence}]
note: <未覆盖范围>

blocked_at 有值时不发布，不要因为「就差一项」而放行。

一句话版

八项全过，可发。 或 卡在第三项：有任务在跑，等它结束。

常见错误

• 把闸门当流程 —— 逐项检查不是「按顺序做八件事」，是「八个问题各自回答是或否」。
• 「就差一项」就放行 —— 那一项往往正是出事的那一项。
• 用通配符推 —— 临时文件、别人的中间产物会被一起带上线。
• 不查线上当前版本 —— 有人先推过了，你再推一遍会覆盖。
• 回退点按时间挑 —— 挑到的可能是新内容，回退时等于没退。
• 只看有没有备份，不核 md5 —— 有一份文件在，不等于它是改动前那一版。
• 推完就说发布完成 —— 没从线上取回来验证，那只是「我按了按钮」。

最后核对

2026-11-06。检查项与环境无关；八项判据通用。与所执行系统的既定标准冲突时，以那个系统的标准为准。