首页/开发/代码质量与评审速查/评审者指南:按层次看改动
代码评审64 条

评审者指南:按层次看改动

Google 评审者指南:先看设计意图再看细节,关注点按'设计 → 功能 → 复杂度 → 测试 → 命名 → 风格'分层推进,风格细节交给工具。

文档How to do a code review(评审者指南)
顺序先整体意图,后代码细节

评审关注层次(自上而下)

层次要回答的问题
设计改动是否放在系统的正确位置,与既有架构是否一致
功能行为是否符合意图;边界、异常、并发路径是否考虑
复杂度有没有更简单的实现;是否为假想需求过度设计
测试测试是否有效、能否失败;关键路径是否覆盖
命名命名是否表达意图,是否与领域术语一致
风格格式细节交给格式化工具,评论时用 nit 前缀
不要从风格细节开始评:先确认整体方向正确,否则评审会失焦。

易错点

  • 跳过设计只看代码行:方向错误时,细节评审全部作废
  • 在评审里展开架构辩论:应尽快转到当面或异步讨论,先把 CL 处理完

数据来源与参考

  • Google Engineering Practices · How to do a code review
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌