测试驱动开发(TDD)
概述
先写测试。看着它失败。编写最小代码让它通过。
核心原则: 如果你没有看着测试失败,你就不知道它是否测试了正确的东西。
违反规则的字面要求,就是违反规则的精神。
何时使用
始终用于:
- 新功能
- Bug 修复
- 重构
- 行为变更
例外(询问你的人类伙伴):
- 一次性原型
- 生成代码
- 配置文件
在想“这一次跳过 TDD”?停下。那是合理化借口。
铁律
NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
先写了代码再写测试?删除它。重新开始。
没有例外:
- 不要把它保留为“参考”
- 不要在写测试时“改编”它
- 不要看它
- 删除就是删除
从测试重新实现。就这样。
红-绿-重构
digraph tdd_cycle {
rankdir=LR;
red [label="RED\nWrite failing test", shape=box, style=filled, fillcolor="#ffcccc"];
verify_red [label="Verify fails\ncorrectly", shape=diamond];
green [label="GREEN\nMinimal code", shape=box, style=filled, fillcolor="#ccffcc"];
verify_green [label="Verify passes\nAll green", shape=diamond];
refactor [label="REFACTOR\nClean up", shape=box, style=filled, fillcolor="#ccccff"];
next [label="Next", shape=ellipse];
red -> verify_red;
verify_red -> green [label="yes"];
verify_red -> red [label="wrong\nfailure"];
green -> verify_green;
verify_green -> refactor [label="yes"];
verify_green -> green [label="no"];
refactor -> verify_green [label="stay\ngreen"];
verify_green -> next;
next -> red;
}
RED - 编写失败测试
写一个最小测试,展示应该发生什么。
const result = await retryOperation(operation);
expect(result).toBe('success'); expect(attempts).toBe(3); });
名称清晰,测试真实行为,只测一件事
</Good>
<Bad>
```typescript
test('retry works', async () => {
const mock = jest.fn()
.mockRejectedValueOnce(new Error())
.mockRejectedValueOnce(new Error())
.mockResolvedValueOnce('success');
await retryOperation(mock);
expect(mock).toHaveBeenCalledTimes(3);
});
名称含糊,测试的是 mock 而不是代码
要求:
- 一个行为
- 清晰名称
- 真实代码(除非不可避免,否则不用 mock)
验证 RED - 看着它失败
强制要求。绝不跳过。
npm test path/to/test.test.ts
确认:
- 测试失败(不是报错)
- 失败消息符合预期
- 因为功能缺失而失败(不是拼写错误)
测试通过了? 你测试的是已有行为。修正测试。
测试报错了? 修复错误,重新运行,直到它正确失败。
GREEN - 最小代码
编写能让测试通过的最简单代码。
不要添加功能、重构其他代码,或做超出测试要求的“改进”。
验证 GREEN - 看着它通过
强制要求。
npm test path/to/test.test.ts
确认:
- 测试通过
- 其他测试仍然通过
- 输出干净(没有错误、警告)
测试失败了? 修代码,不要修测试。
其他测试失败了? 现在修复。
REFACTOR - 清理
只能在 green 之后:
- 移除重复
- 改进命名
- 提取 helper
保持测试为 green。不要添加行为。
重复
为下一个功能编写下一个失败测试。
好测试
| 质量 | 好 | 差 |
|---|---|---|
| 最小化 | 一件事。名称里有 "and"?拆分它。 | test('validates email and domain and whitespace') |
| 清晰 | 名称描述行为 | test('test1') |
| 展示意图 | 展示期望的 API | 模糊代码应该做什么 |
为什么顺序重要
“我之后会写测试来验证它能用”
代码之后写的测试会立即通过。立即通过什么也证明不了:
- 可能测试了错误的东西
- 可能测试的是实现,而不是行为
- 可能漏掉你忘记的边界情况
- 你从未看到它捕获 bug
测试先行会迫使你看到测试失败,证明它确实测试了某个东西。
“我已经手动测试了所有边界情况”
手动测试是临时性的。你以为测试了所有内容,但:
- 没有记录你测试过什么
- 代码变更时无法重新运行
- 压力下很容易忘记用例
- “我试的时候能用” ≠ 全面
自动化测试是系统化的。它们每次都以相同方式运行。
“删除 X 小时的工作是浪费”
沉没成本谬误。时间已经花掉了。你现在的选择是:
- 删除并用 TDD 重写(再花 X 小时,高信心)
- 保留它并事后添加测试(30 分钟,低信心,可能有 bug)
真正的“浪费”是保留你无法信任的代码。没有真实测试的工作代码是技术债。
“TDD 很教条,务实意味着灵活调整”
TDD 就是务实:
- 在提交前发现 bug(比事后调试更快)
- 防止回归(测试会立即捕获破坏)
- 记录行为(测试展示如何使用代码)
- 支持重构(自由修改,测试捕获破坏)
“务实”捷径 = 在生产中调试 = 更慢。
“事后测试能达成同样目标——重要的是精神,不是仪式”
不是。事后测试回答“这做了什么?”测试先行回答“这应该做什么?”
事后测试会受你的实现偏置影响。你测试的是你构建的东西,而不是需求要求的东西。你验证的是记得的边界情况,而不是发现的边界情况。
测试先行迫使你在实现前发现边界情况。事后测试是在验证你记住了一切(你没有)。
30 分钟事后补测试 ≠ TDD。你得到了覆盖率,却失去了测试有效的证明。
常见合理化借口
| 借口 | 现实 |
|---|---|
| “太简单了,不用测试” | 简单代码也会坏。测试只需 30 秒。 |
| “我之后再测试” | 测试立即通过什么也证明不了。 |
| “事后测试能达成同样目标” | 事后测试 = “这做了什么?”测试先行 = “这应该做什么?” |
| “已经手动测试过了” | 临时性 ≠ 系统化。没有记录,无法重新运行。 |
| “删除 X 小时的工作是浪费” | 沉没成本谬误。保留未验证代码是技术债。 |
| “保留作参考,先写测试” | 你会改编它。那就是事后测试。删除就是删除。 |
| “需要先探索” | 可以。丢弃探索代码,然后从 TDD 开始。 |
| “测试很难 = 设计不清晰” | 听测试的。难测试 = 难使用。 |
| “TDD 会拖慢我” | TDD 比调试更快。务实 = 测试先行。 |
| “手动测试更快” | 手动测试无法证明边界情况。每次变更都要重测。 |
| “现有代码没有测试” | 你在改进它。为现有代码添加测试。 |
危险信号——停下并重新开始
- 先写代码,后写测试
- 实现后再测试
- 测试立即通过
- 无法解释测试为什么失败
- “稍后”添加测试
- 用“就这一次”合理化
- “我已经手动测试过了”
- “事后测试也能达到同样目的”
- “重要的是精神,不是仪式”
- “保留作参考”或“改编现有代码”
- “已经花了 X 小时,删除太浪费了”
- “TDD 很教条,我这是务实”
- “这次不一样,因为……”
所有这些都意味着:删除代码。用 TDD 重新开始。
示例:Bug 修复
Bug: 空 email 被接受
RED
test('rejects empty email', async () => {
const result = await submitForm({ email: '' });
expect(result.error).toBe('Email required');
});
验证 RED
$ npm test
FAIL: expected 'Email required', got undefined
GREEN
function submitForm(data: FormData) {
if (!data.email?.trim()) {
return { error: 'Email required' };
}
// ...
}
验证 GREEN
$ npm test
PASS
REFACTOR 如有需要,为多个字段提取验证。
验证检查清单
在标记工作完成前:
- 每个新 function/method 都有测试
- 实现前看着每个测试失败
- 每个测试都因预期原因失败(功能缺失,而不是拼写错误)
- 编写最小代码让每个测试通过
- 所有测试通过
- 输出干净(没有错误、警告)
- 测试使用真实代码(只有不可避免时才用 mock)
- 覆盖边界情况和错误
无法勾选所有项?你跳过了 TDD。重新开始。
卡住时
| 问题 | 解决方案 |
|---|---|
| 不知道如何测试 | 写出期望的 API。先写断言。询问你的人类伙伴。 |
| 测试太复杂 | 设计太复杂。简化接口。 |
| 必须 mock 一切 | 代码耦合太高。使用依赖注入。 |
| 测试设置巨大 | 提取 helper。仍然复杂?简化设计。 |
调试集成
发现 bug?编写失败测试复现它。遵循 TDD 循环。测试证明修复有效并防止回归。
绝不要在没有测试的情况下修 bug。
测试反模式
添加 mocks 或 test utilities 时,阅读 @testing-anti-patterns.md 以避免常见陷阱:
- 测试 mock 行为而不是真实行为
- 向生产类添加只供测试使用的方法
- 在不理解依赖的情况下 mock
最终规则
Production code → test exists and failed first
Otherwise → not TDD
没有你的人类伙伴许可,不允许例外。