首页/开发/代码质量与评审速查/生成代码的评审方法
代码评审64 条

生成代码的评审方法

生成代码(ORM 迁移、protobuf、模板产物)重点不看逐行实现,而看输入与生成规则:源头正确、差异符合预期、生成物可重现。

  • 查源头:schema、接口定义、模板的改动是否合理
  • 查生成命令与版本:生成器升级带来大 diff,应单独提交
  • 查差异模式:确认没有超出预期的删除与重命名
  • 生成物与手写逻辑分目录:避免人工修改被下次生成覆盖
手改生成产物是坑:下次生成即丢失,评审时应要求回到源头改。
复查顺序源头定义、生成命令与版本、差异模式三层
可重现验证重新生成一遍,确认产物与提交完全一致

易错点

  • 手改生成文件:下次生成被覆盖,改动静默丢失
  • 生成器升级与业务改动混提:diff 巨大,难以定位问题

数据来源与参考

  • protobuf 官方文档(生成代码管理)
  • OpenAPI Generator 文档(生成产物工作流)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌