智汇 IT
城启新篇

代码评审为什么总在第二十分钟变味

下午三点。会议室或者线上房间,四个人盯着同一块屏幕。第一分钟大家还客气,说“整体思路没问题”。到第二十分钟,有人开口了:这个变量名能不能改一下。

改名不是坏事。真正的问题是,前面十九分钟里,已经没人看逻辑了。

评审最容易死在规模上

我采访过不少做后端和基础架构的团队,聊到代码评审,抱怨的点高度重合。不是工具难用,是活儿太多。

一个人一天能认真读完多少行 diff?没有标准答案。但有个经验值流传很广:一次评审控制在两百到四百行之间,超过这个量,审查者的注意力会断崖式下滑。

说白了,人脑不是静态分析器。

麻烦在于,提交的人不这么想。一个功能做了两周,中间改过三次方案,最后塞进一个八百行的 PR 里,标题写着“feat: 订单模块重构”。

你让评审者怎么办。他要么花两小时真正读透,要么扫一眼点通过。多数人选后者。

代码评审界面 diff 行内评论截图
代码评审界面 diff 行内评论截图

这不是态度问题,是带宽问题。你没法要求一个每天开四个会、还要写自己代码的人,对每个 PR 都做深度审查。

LGTM 是怎么变成默认选项的

LGTM 是怎么变成默认选项的
LGTM 是怎么变成默认选项的

有个现象挺有意思。越是资深的工程师,越容易给出 LGTM。

原因不复杂。他见过太多写法,知道大部分争议其实不重要——命名风格、日志级别、异常怎么包装,这些确实可以吵,但吵赢了也不改变系统行为。

于是他学会了放过。

代价在于,团队里的新人会模仿这个动作。他看见 tech lead 三秒钟点通过,就以为评审本来就该这样。半年之后,整个团队的评审文化就变成了盖章。

这事没那么玄。机制问题经常被当成人的问题来治。

评审到底在评什么

评审到底在评什么
评审到底在评什么

我听过一个说法,比大多数定义都准:代码评审主要是为了传递知识和发现设计问题,找 bug 只是副产品。

按这个标准看,很多评审跑偏了。

大家在 diff 里找拼写错误、找多余的空行、找 import 顺序。这些活儿有工具能做,而且做得比人好。把人的时间花在这上面,等于拿手术刀削铅笔。

真正需要人判断的问题,往往长得不那么显眼:

这段逻辑放错层了,本该在 service 里,现在塞进了 controller。这个接口的返回值以后一定会膨胀,现在定死了。这里加了个缓存,但没人知道它什么时候失效。这个字段被三个模块共享,改它等于同时改三个系统。

这些问题,静态检查看不见。只有熟悉业务和历史包袱的人能看出来。

问题也就在这。看得出来的那个人,通常最忙。

我见过一种挺典型的翻车方式。一个改动涉及权限判断,三位评审者都点了通过,理由各不相同:一个只看了命名,一个只看了测试,一个信任前两位。上线两周后一个问题被翻出来,回溯时发现,没有人真正读过那个 if 分支。四个人都签了字,等于零个人签了字。

把评论分出轻重

有个实践我觉得挺值,虽然听起来很土:给评论加前缀。

nit,这是个人偏好,你不改我也不拦着。question,我没看懂,解释一下。blocker,这个必须改,不然我不批。

就这么简单一件事,能省掉大量误会。因为大多数评审冲突不是因为技术分歧,而是因为语气。

一句“这里应该用 Map 而不是 Object”,写在评论框里,读起来就是命令。加个 nit 前缀,同样的话变成了建议。信息量没变,接收方的防御姿态没了。

工程师深夜盯着显示器看代码评审
工程师深夜盯着显示器看代码评审

英文社区里这个做法很常见。国内团队用得少,可能觉得啰嗦。你算一下,一个团队一年产生多少条评审评论,里面有百分之多少是纯粹的格式之争。加上前缀,这部分就能自动降级,不再占用双方的情绪额度。

谁在承担这笔时间成本

谁在承担这笔时间成本
谁在承担这笔时间成本

最后说个不太好听的。

代码评审是典型的成本外部化。写代码的人省了时间,他急着交付,PR 扔出去就不管了。评审的人付出了时间,而这个时间通常不体现在任何指标里。

于是最负责任的那几个人,变成了团队里最累的人。他们的产出被评审挤掉,年底绩效还未必好看。

这套激励不改,任何流程都撑不住。

有些团队开始做计时,统计 PR 从提交到合并的中位时长,或者统计评审响应时间。我觉得这些指标有用,前提是别拿来考核个人。一旦变成 KPI,大家立刻开始互相秒批,数据好看了,质量掉了。

还有个更省事的做法:把 PR 写小。

小 PR 不需要任何文化变革,它自己就解决了注意力问题。一次改一个逻辑单元,提交信息写清楚为什么改。评审者十分钟看完,还能说点有营养的话。

工具、模板、检查清单,这些都是外围。核心只有一句:你有没有给评审这件事留出真正的时间。

没有的话,评审就只是一个按钮。

免责声明:市场有风险,选择需谨慎!此文仅供参考,不作买卖依据。如有侵权请联系删除。
文章名称:代码评审为什么总在第二十分钟变味
文章链接:https://www.itcdj.com/news/971.html