# 通用代码评审检查清单 适用于所有项目,补充五视角扫描法。 ## API 设计 - [ ] RESTful 命名是否规范?(复数名词、无动词) - [ ] 分页参数是否有默认值和上限? - [ ] 响应格式是否统一?(code/message/data) ## 错误处理 - [ ] 错误是否被正确传播?(不要吞掉错误) - [ ] 用户可见的错误消息是否友好?(不暴露技术细节) - [ ] 是否有 panic recover 兜底? ## 性能 - [ ] 列表查询是否有分页?(不允许无限制查询) - [ ] N+1 查询问题?(循环内查数据库) - [ ] 是否有不必要的全表扫描?(缺少索引) ## 可维护性 - [ ] 魔法数字是否提取为常量? - [ ] 复杂业务逻辑是否有注释说明? - [ ] 函数是否过长?(超过 100 行考虑拆分)