Rust / 系统课时
把测试规范写进代码评审流程
把测试规范写进代码评审流程
测试规范只有停留在团队口头约定里,新增逻辑和缺陷修复就很容易出现“这次先不测”。真正可持续的做法,是把测试要求变成代码评审时能逐项确认的证据,并根据变更类型规定最低检查项,让评审关注风险而不是机械追求测试数量。
学习目标
- 能按新增逻辑、缺陷修复和公共 API 变更建立测试检查项
- 能把测试证据放进 Pull Request 的固定结构
- 能识别“有测试但没有验证到风险”的常见问题
先定义变更类型与最低证据
评审规则最好从变更意图出发,而不是要求所有 PR 都执行同一套测试。新增业务逻辑时,重点确认核心规则和边界;修复缺陷时,重点确认是否新增了能复现原问题的回归测试;公共 API 变更时,则要确认对外行为、错误路径以及调用方契约是否受到验证。
| 变更类型 | 至少检查什么 | 典型证据 |
|---|---|---|
| 新增逻辑 | 核心路径与边界 | 单元测试或对应集成测试 |
| 缺陷修复 | 原问题可被复现并防回归 | 回归测试 |
| 公共 API 变更 | 成功、失败和兼容行为 | 集成测试、必要时文档示例 |
| 重构但行为不变 | 关键行为仍被覆盖 | 既有测试通过,必要时补边界测试 |
把检查项固定在 Pull Request
评审模板的价值不是增加仪式,而是让作者在提交前主动回答“为什么这样测”。例如项目可以在 Pull Request 描述中固定以下内容,并要求作者删除不适用项后再提交:
## 测试评审
- [ ] 新增逻辑已覆盖核心行为和关键边界
- [ ] 缺陷修复已增加可复现原问题的回归测试
- [ ] 公共 API 变更已验证成功与失败路径
- [ ] 未新增测试时,已说明风险和原因
- [ ] 已运行与本次变更直接相关的测试预期结果
打开 Pull Request 后,描述区域出现“测试评审”检查清单;作者可以逐项勾选,并在没有新增测试时补充原因。这类清单应当成为评审入口,而不是替代测试本身。勾选“已覆盖”不等于覆盖有效,评审仍需要查看测试是否验证了真正的风险。
用代码评审识别假覆盖
最常见的假覆盖是测试只证明“代码能运行”,却没有证明“错误条件被阻止”。例如一个新增的权限判断,如果测试只覆盖成功路径,那么权限绕过仍可能存在。评审时应追问三件事:正常路径是什么、最容易出错的边界是什么、失败时系统应该表现为什么。
对于缺陷修复,尤其要避免只修改测试数据、不保留原始失败条件。一个合格的回归测试应该在修复前能够失败,在修复后能够稳定通过,并且尽量直接表达问题原因。
让规范逐步自动化
评审清单适合约束“是否考虑过”,CI 更适合约束“是否通过验证”。可以把固定的 Rust 检查接入流水线,让评审者看到可重复的测试结果,而不是只依赖作者描述。
cargo test预期输出
Finished test profile
Running unittests
Running tests
Doc-tests
test result: ok这里的具体输出会随 Rust 工具链和项目测试数量变化,因此评审应关注命令是否成功以及失败测试的名称,而不是要求日志文本完全一致。
公共 API 变更要看契约,不只看覆盖率
当一个 pub 函数、类型或错误返回发生变化时,评审重点应该转向调用者看到的契约。例如参数约束变化可能新增失败分支,返回值变化可能要求更新集成测试。覆盖率上升并不能自动证明兼容性正确,因此公共 API 变更应优先检查公开行为。
最终可以把测试规范压缩成一条评审习惯:每次变更都要说明风险、测试要证明什么,以及证据在哪里。 当这些问题固定出现在 PR 模板和 CI 中,测试就从“作者自觉补充的文件”变成了工程交付的一部分。