编写、评审或重构测试时：按能捕获的缺陷选择测试…

在编写、评审或重构测试，或为代码变更选择验证方式时使用。

适用场景

解决思路

1. 为测试能捕获的缺陷选择测试；保留有用的回归覆盖，同时不要将测试绑定到偶然的实现细节。
2. 识别正在变更的行为，以及每个新增或修改测试应捕获的具体缺陷；测试不必检测无关缺陷。
3. 遵循项目说明和现有测试约定，优先于默认做法。
4. 运行受影响的测试和必需检查；当变更的依赖、失败或未解决风险证明有必要时，扩大覆盖范围。
5. 不要仅为满足测试偏好而改变生产架构；需要为请求的修复进行重构时再重构，独立重构应另行提议。
6. 仅当需要 runner 或 fixture 指导时，读取下面相关的语言文件；通用代码指导在 `code-craft`。
7. 优先通过功能的公共边界测试输入和可观察输出。
8. 对于大型算法或不变量，私有 helper 可以值得直接测试；不要仅为了测试而将它们改为 public。
9. 使用能捕获风险的最便宜层级。
10. 解析、纯逻辑、状态转换：从单元测试开始。
11. 组件之间的协作：从真实对象或维护良好的 fake 开始。
12. 服务或 HTTP 契约：从使用 hermetic server 或 contract-tested fake 的集成测试开始。
13. UI 接线：驱动渲染后的控件，而不是调用其 handler。
14. 跨系统行为：从聚焦的端到端测试开始。
15. 当现有自动化覆盖变更行为时，使用现有自动化。
16. 手动演练在能捕获自动化无法捕获的风险时有用，例如视觉布局。
17. 识别源码文本断言和精确内部调用脚本这类可疑测试：它们常常固定实现而不保护契约。
18. 对可疑测试，识别它保护的行为。
19. 对可疑测试，识别会使它失败的具体缺陷。
20. 对可疑测试，判断它是否会拒绝具有相同行为的有效实现。
21. 将脆弱断言重写为检查结果、状态、渲染输出或外部效果。
22. 仅当测试没有有用契约可保护，或覆盖冗余时，才删除测试；测试通过而某些其他行为出错，不是删除它的理由。
23. 当交互本身就是契约时，使用交互断言，例如发送一封电子邮件、在缓存命中时避免网络请求、在写入前检查授权；只断言相关的调用和参数。
24. 当真实实现快速、确定、隔离时，优先使用它；在有用时使用临时目录、一次性仓库或本地服务器。
25. 当真实依赖不合适时，对状态化行为使用窄的 working fake；在实际可行时，用真实契约检查共享 fake。
26. 当真实依赖不合适时，对预设查询结果或强制失败使用 stub。
27. 当真实依赖不合适时，对发生、缺失或顺序本身就是契约的交互使用 mock。
28. 避免复制实现细节的复杂 mock 设置。
29. 围绕第三方依赖的 wrapper 可以提供稳定 seam，但不要仅为遵守禁止 mock 自己无法拥有的类型而添加 wrapper。
30. 当适合时，使用项目已有的 seam 和库支持的测试工具。
31. 命名场景和预期结果；保持因果关系可见。
32. 将相关输入和预期保留在测试体内；辅助函数可以隐藏无关构造，表驱动用例对并行场景有用。
33. 不要通过重复生产算法来计算预期结果。
34. 选择能暴露交换输入或意外默认值的不同值；当空、零和边界值是被测行为时，包含它们。
35. 断言重要的字段；当整个对象就是契约时，使用完整对象相等，而不是对偶然细节做宽泛快照。
36. 让失败显示预期值和实际值。
37. 覆盖相关失败路径和边界；当不变量或大输入空间证明有必要时使用 property tests，不要仅因为库可用就使用。
38. 等待完成信号或可观察条件并带超时；不要 sleep 任意时长并假设工作完成。
39. 当时间或随机性影响结果时，控制它们。
40. 在测试之间隔离可变状态。
41. 通过受控依赖或输入，使重要失败可复现。
42. 对于 bug 修复，在可行时先于修改生产代码复现实际失败；确认回归测试因预期原因失败，然后在修复后通过。
43. 对于其他变更，识别断言检测的缺陷；当敏感度不确定或风险需要时，使用定向 mutation。
44. 如果修改生产代码进行 mutation，隔离实验并在继续前恢复它。
45. 反转断言检查的是执行，而不是对预期缺陷的敏感度。
46. 常规测试编辑和 green-to-green 重构不需要生产 mutation。
47. 保留覆盖的行为，并在重构前后比较相关结果。
48. 报告你无法执行的验证。
49. 当需要 runner、fixture 或 async-test 细节时，读取 Rust 的 `languages/rust.md`。
50. 当需要 runner、fixture 或 async-test 细节时，读取 TypeScript / JavaScript 的 `languages/typescript.md`。
51. 当需要 runner、fixture 或 async-test 细节时，读取 Go 的 `languages/go.md`。
52. 当需要 runner、fixture 或 async-test 细节时，读取 Python 的 `languages/python.md`。
53. 对于其他语言，遵循项目约定。

适用边界 · 注意事项

• 不要仅为满足测试偏好而改变生产架构；需要为请求的修复进行重构时再重构，独立重构应另行提议。
• 不要仅为了测试而把私有 helper 改为 public。
• 不要仅为遵守禁止 mock 自己无法拥有的类型而添加 wrapper；优先使用项目已有 seam 和库支持的测试工具。