智汇 IT
城启新篇

代码评审别把聪明用错地方

先看个场景。有人提了个 PR,标题写修复空指针。点开 diff,三百行。评论区第一条是这里命名不够优雅。十分钟后作者回了个 OK。然后没了。三天后,分支落后主干两百个提交。

这不是段子。它精确展示了代码评审里最常见的错位:把评审当品味裁判,而不是风险过滤。错位一出现,速度、士气、代码质量一起掉。

别把评审当法庭

评审的目标不是证明谁更聪明。目标很土:在合并前抓住那些机器抓不住、上线后代价又很高的东西。

正确性。边界条件。并发。安全。数据迁移。测试缺口。接口兼容。还有,这段代码三个月后还有人敢改吗。

命名风格呢?缩进呢?让 formatter 和 linter 去吵。真的。人吵这些,成本太高。

麻烦在于,很多团队没有评审目标。大家凭感觉点开 diff,看到什么说什么。于是评论数量上去了,关键问题漏掉了。评审人很累,作者很烦,最后双方都学会敷衍:你写 LGTM,我写感谢。

我见过一个团队把评论分成三档:must fix、should fix、nit。很管用。作者知道哪些必须回,哪些可以记 issue。评审人也不用假装每个逗号都关乎系统稳定。

代码评审评论线程中标注必须修改与建议修改的截图
代码评审评论线程中标注必须修改与建议修改的截图

取舍很直接。评审越宽,合并越快,遗漏风险越高。评审越严,质量幻觉越强,交付节奏越紧。代价不是抽象的,它会变成加班、回滚、互相甩锅。

两百行定律和它的坑

很多团队有个硬规矩:PR 不超过两百行。听上去很美。小 diff 容易看,评论聚焦,回滚也简单。

但硬切碎会出事。一个完整的数据模型改动,被拆成五个 PR。每个看起来都无害。合到第三个,测试开始飘。合到第五个,线上报错。评审人看的是碎片,没人看见全貌。

说白了,粒度要跟着变更的内聚性走。一个逻辑变更,尽量一个 PR。纯格式化、重命名、依赖升级,可以单独拆。别为了行数指标把上下文砍碎。

还有个现实问题:小 PR 多了,CI 排队、评审切换、分支同步,全是隐形成本。你以为省了评审脑力,其实把它挪到了集成阶段。

Git合并请求代码差异高亮与行数统计界面
Git合并请求代码差异高亮与行数统计界面

我的建议很朴素。超过四百行的 diff,作者先自己读一遍。能不能拆?能拆就拆。拆完每个 PR 能不能独立通过测试?不能就别硬拆。

谁有资格按下批准

批准按钮很轻,责任很重。它不是点赞,也不是社交礼仪。

有的团队用 CODEOWNERS。有的靠资历。有的轮值。每种都有坑。CODEOWNERS 容易卡在少数人身上,他们一休假,合并队列就堵。轮值能分摊,但轮到一个不熟模块的人,评审会变成走过场。

比较实际的做法:关键模块至少一个懂行的人看。普通改动,一个同组工程师加自动化门禁就够。别让所有 PR 都等架构师。架构师不是收费站。

评审人最该看的是意图和边界,不是复述代码。如果作者写了清晰的描述、测试和风险说明,评审时间能砍半。如果描述只有“fix bug”,那评审人只能靠猜。猜出来的批准,和赌没区别。

代价也要说清。依赖少数专家,短期稳,长期脆。培养更多能批准的评审人,短期慢,长期稳。选哪个,看团队想活多久。

评审里的语言比技术更难

评审里的语言比技术更难
评审里的语言比技术更难

技术问题通常有答案。沟通问题没有。

同一句话,写法不同,结果差很远。“这不对”是判决。“这里在并发下可能重入,我在第 42 行看到锁的范围偏大”是信息。后者能讨论,前者只能防御。

提问比命令好用。“为什么不用缓存”容易吵。“这个查询在热点路径上,加缓存会不会更稳”更像合作。别小看语气,远程协作里,文字没有表情,标点都像刀子。

还有时差。异步评审看起来高效,实际上容易把一个小疑问拖成一天的等待。紧急修复可以拉个短会,共享屏幕,五分钟解决。别把同步沟通当失败。

沉默同意也很危险。没人评论,不等于没人反对。可能只是大家没看。或者看了,觉得说了也没用。批准文化一旦变成礼貌文化,评审就死了。

度量别把评审变成 KPI

有些团队开始统计评审数据。评论数、批准速度、每人评审量。数据本身没错,错的是拿它考核。

一旦评论数进绩效,大家就会写废话。一旦批准速度进绩效,大家就会不看代码直接点通过。Goodhart 定律在这儿特别好用:指标变成目标,就不再是好指标。

更稳的用法是看趋势。评审延迟中位数有没有变长?PR 大小分布是不是越来越大?返工率有没有上去?这些信号用来调整流程,不用来给人打分。

工具能帮忙。自动化测试、静态检查、格式化、依赖漏洞扫描,能挡的就别让人挡。人的注意力很贵,留给设计取舍和边界条件。

老代码和新人的局

老代码和新人的局
老代码和新人的局

新人改老模块,评审最容易变成历史课。评审人知道十个坑,但讲不清。新人只看到一坨代码,改一行,炸三处。

怎么办?先用测试锁住旧行为。再小步改。评审评论别写“这里一直有问题”,写清楚触发条件和影响。能补测试就补测试。不能补,至少留个注释或者 issue 链接。

老代码不是不能碰。是不能蒙着眼碰。评审在这里的价值,不是阻止改动,而是把隐式知识变成显式约束。

代价当然有。补测试慢。讲清楚更慢。但下一次改动会快。团队的知识不会只长在某个人脑子里。

代码评审没有万能流程。它更像一种团队习惯。习惯好,工具差一点也能跑。习惯差,工具再贵也白搭。

如果评审让人害怕,代码不会更好。只会更会藏。真正有用的评审,是能让作者说“这里我可能错了”,也能让评审人说“这块我不确定,我们一起看”。

就这样。

免责声明:市场有风险,选择需谨慎!此文仅供参考,不作买卖依据。如有侵权请联系删除。
文章名称:代码评审别把聪明用错地方
文章链接:https://www.itcdj.com/news/885.html