文章 · 工程化

给团队写的一份代码评审清单

评审最容易漏的不是语法,是那些「跑得起来但以后会疼」的地方。把反复出现的问题写成清单,评审时照着过一遍,比依赖记性靠谱得多。

先看边界

  • 空值与异常路径是否都有处理,而不是只覆盖了顺利情况
  • 并发场景下共享状态有没有被同时改写
  • 外部输入有没有做校验,还是直接信任了上游

再看命名与结构

命名能不能让后来的人不点进实现就猜出用途,是这一块唯一的标准。函数超过一屏、参数超过四个、嵌套超过三层,都值得当场提出来。

最后看测试与提交信息

改行为有没有同时改测试,提交信息说的是「为什么」还是只说了「做了什么」。这两条决定了三个月后的人能不能理解这次改动。

评论6

访客

登录后参与评论,你的发言会署上自己的名字。

  • 陈默

    陈默作者@chenmo2026-09-10

    放在最前面:看到都会回,先谢过各位补充的经验。

  • 孟凡

    孟凡@mengfan2026-09-11

    构建脚本重写那段看着很有共鸣,最花时间的果然还是新旧产物对照。

  • 程野

    程野@chengye2026-09-12

    这份清单可以直接拿去做评审模板了,覆盖面挺全。

  • 姜堰

    姜堰@jiangyan2026-09-13

    命名那一条看着简单,但确实是评审里最常被提出来的问题。

  • 童语

    童语@tongyu2026-09-14

    边界情况那段写得好,很多问题都是顺利路径跑通了就当完成了。

  • 严冬

    严冬@yandong2026-09-15

    状态管理这块我更倾向于能不放全局就不放,理解成本差很多。