测试驱动开发 是做什么的?
哲学
核心原则:测试应通过公共接口验证行为,而非实现细节。代码可以完全改变;测试不应改变。
好测试是集成风格的:它们通过公共 API 执行真实代码路径。它们描述的是系统做什么,而不是怎么做。好的测试读起来像一份规范——“用户可以用有效购物车结账”告诉你确切存在什么能力。这些测试能经受重构,因为它们不关心内部结构。
坏测试与实现耦合。它们模拟内部协作者、测试私有方法,或通过外部手段(例如直接查询数据库而不是使用接口)进行验证。警示信号:重构时测试失败,但行为并未改变。如果你重命名一个内部函数导致测试失败,那么这些测试测试的是实现,而不是行为。
有关示例,请参见 tests.md;有关模拟指南,请参见 mocking.md。
反模式:水平分割
不要先编写所有测试,再编写所有实现。 这就是“水平分割”——将 RED 阶段视为“编写所有测试”,将 GREEN 阶段视为“编写所有代码”。
这会产生糟糕的测试:
- 批量编写的测试测试的是想象的行为,而不是实际的行为
- 你最终会测试事物的形状(数据结构、函数签名),而不是面向用户的行为
- 测试对真实变化不敏感——行为破坏时通过,行为正常时失败
- 你盲目前行,在理解实现之前就确定了测试结构
正确方法:通过示踪子弹进行垂直切片。一个测试 → 一个实现 → 重复。每个测试都响应你从上一个循环中学到的东西。因为你刚刚写了代码,所以你确切知道什么行为重要以及如何验证它。
错误(水平):
RED: test1, test2, test3, test4, test5
GREEN: impl1, impl2, impl3, impl4, impl5
正确(垂直):
RED→GREEN: test1→impl1
RED→GREEN: test2→impl2
RED→GREEN: test3→impl3
...
工作流程
1. 规划
探索代码库时,阅读 CONTEXT.md(如果存在),以使测试名称和接口词汇与项目的领域语言匹配,并尊重你所触及区域的 ADR。
在编写任何代码之前:
- 与用户确认需要哪些接口更改
- 与用户确认要测试哪些行为(优先排序)
- 识别深层模块的机会(小接口,深实现)——运行
/codebase-design技能以获取词汇和可测试性检查 - 列出要测试的行为(而非实现步骤)
- 获取用户对计划的批准
提问:“公共接口应该是什么样的?哪些行为最重要需要测试?”
你不可能测试所有东西。 与用户确认确切哪些行为最重要。将测试工作集中在关键路径和复杂逻辑上,而不是每个可能的边界情况。
2. 示踪子弹
编写一个测试,确认系统的一个事实:
RED: 编写第一个行为的测试 → 测试失败
GREEN: 编写最简代码使其通过 → 测试通过
这是你的示踪子弹——证明路径端到端可用。
3. 增量循环
对于剩余每个行为:
RED: 编写下一个测试 → 失败
GREEN: 最简代码使其通过 → 通过
规则:
- 一次一个测试
- 只编写足以通过当前测试的代码
- 不要提前为未来测试做准备
- 保持测试聚焦于可观察行为
4. 重构
所有测试通过后,查找重构候选:
- 提取重复
- 深化模块(将复杂性放到简单接口背后)
- 在自然的地方应用 SOLID 原则
- 考虑新代码揭示了现有代码的什么信息
- 每次重构步骤后运行测试
永远不要在 RED 状态下重构。 先达到 GREEN。
每个循环的检查清单
[ ] 测试描述行为,而非实现
[ ] 测试只使用公共接口
[ ] 测试在内部重构后依然能通过
[ ] 代码对于此测试是最简的
[ ] 没有添加推测性功能