
两种典型失败:一是流程太重,一次改动要等两天才有反馈,最后大家绕过流程;二是没有标准,审查变成风格争论,谁都说不清什么算通过。
轻量方案的目标是把审查变成十分钟内能完成的事。
单次改动控制在可读范围内,改动越大,审查质量越低。把大改动拆成若干小提交,每个提交只做一件事。
格式调整与逻辑修改分开提交,审查者才能看清真正的变化。
清单只列真正重要的项:是否有明显逻辑错误;边界条件是否处理;错误是否被吞掉;是否有敏感信息硬编码;是否影响已有接口;是否补充了必要测试。
清单不列风格问题。风格交给格式化工具,人工审查只关注正确性与风险。
约定审查在半天内给出反馈,超时则先合并并标记后续跟进。长时间挂起的改动会不断产生冲突,成本比问题本身更高。
紧急修复可以事后补审,但要留下记录,避免形成惯例。
文档修改、注释补充、依赖小版本升级、纯格式化提交,可以走简化流程。免审范围要写清楚,否则会被不断扩大。
免审不等于不记录,提交信息仍要说明改了什么。
区分必须修改与建议改进,用明确措辞标注。只写“这里不太好”会让作者无从下手。
对不确定的地方提问而不是下结论,很多所谓问题源于审查者不了解上下文。
除了发现缺陷,审查还是知识传递的过程。新成员通过审查了解项目约定,老成员通过审查发现设计问题。
因此审查意见应当解释原因,而不是只给结论。
看两个信号:上线后由改动引入的缺陷是否减少;审查平均耗时是否可控。前者说明质量,后者说明可持续性。
若质量提升但耗时失控,说明清单太长或范围太大,需要收敛。
代码审查不是仪式,而是一次低成本的交叉验证。范围小、清单短、响应快,小团队同样能长期坚持。
审查记录本身也有价值,把反复出现的问题归纳进清单,清单会越来越贴合项目实际,比照搬通用规范有效得多。
清单每季度复盘一次,删掉不再适用的项,比不断追加更能保持执行力。