测试驱动开发
TDD 是红 → 绿 → 重构循环。此技能是让该循环产生值得保留的测试的参考:好的测试是什么、测试放在哪里、反模式以及循环的规则。每个部分在每个周期中都有用——在循环之前和期间参考它们,而不是之后。
在探索代码库时,请阅读 CONTEXT.md(如果存在),以便测试名称和接口词汇与项目的领域语言匹配,并尊重您所涉及区域的 ADR。
什么是好的测试
测试通过公共接口验证行为,而不是实现细节。代码可以完全改变;测试不应该。好的测试读起来像规范——"用户可以使用有效购物车结账" 准确地告诉您存在什么功能——并且因为不关心内部结构,在重构后依然有效。
参见 tests.md 获取示例,以及 mocking.md 获取模拟指南。
接缝——测试放在哪里
接缝是被测试模块呈现其接口的地方:您在不深入内部的情况下观察行为。测试位于接缝处,绝不针对内部。
在编写测试之前,先确定被测试的接缝。如果现有的公共接口是明显的接缝,就声明它并继续。如果接缝是新的或不明确的,请先与用户确认。您无法测试所有内容——有意识地选择接缝是让测试工作落在关键路径和复杂逻辑上,而不是每个边缘情况上的方式。
提问:"公共接口是什么,我们应该测试哪些接缝?"
反模式
- 与实现耦合——模拟内部协作对象、测试私有方法,或通过侧通道(查询数据库而不是使用接口)进行验证。迹象:当您重构但行为未改变时,测试失败。
- 同义反复——断言以与代码相同的方式重新计算期望值(
expect(add(a, b)).toBe(a + b),以相同方式手动推导的快照,断言等于自身的常量),所以它通过构造直接通过,永远无法与代码不一致。期望值必须来自独立的真相源——已知正确的字面量、已计算的示例或规范。 - 水平切片——先编写所有测试,然后实现所有代码。批量测试验证的是_想象_中的行为:您测试的是事物的_形状_而非用户可见的行为,测试对实际变化不敏感,并且在理解实现之前就承诺了测试结构。应该以垂直切片方式工作——一个测试 → 一个实现 → 重复,每个测试都是一个追踪子弹,响应上一个循环教给您的信息。
循环的规则
- 先红后绿。 先编写失败的测试,然后只编写足够通过它的代码。不要预期未来的测试或添加推测性的功能。
- 一次一个切片。 每个循环只有一个接缝、一个测试、一个最小实现。
- 绿后重构。 在保持行为不变且测试通过的情况下改进名称和结构。不要在重构期间添加新行为;更广泛的架构更改属于审查阶段(参见
code-review技能)。