test-driven-development

Test-Driven Development

概览

先写一个失败测试，再写让它通过的代码。修 bug 时，在尝试修复前先用测试复现 bug。测试是证据，“看起来对”不算完成。拥有良好测试的代码库是 AI agent 的超能力；没有测试的代码库则是一种负债。

何时使用

• 实现任何新逻辑或行为
• 修复任何 bug（Prove-It Pattern）
• 修改现有功能
• 添加边界情况处理
• 任何可能破坏现有行为的变更

何时不要使用： 纯配置变更、文档更新，或没有行为影响的静态内容变更。

相关： 对基于浏览器的变更，将 TDD 与使用 Chrome DevTools MCP 的运行时验证结合使用。见下方 Browser Testing 部分。

TDD 循环

    RED                GREEN              REFACTOR
 Write a test    Write minimal code    Clean up the
 that fails  ──→  to make it pass  ──→  implementation  ──→  (repeat)
      │                  │                    │
      ▼                  ▼                    ▼
   Test FAILS        Test PASSES         Tests still PASS

步骤 1：RED，编写失败测试

先写测试。它必须失败。一个立即通过的测试什么都证明不了。

// RED: This test fails because createTask doesn't exist yet
describe('TaskService', () => {
  it('creates a task with title and default status', async () => {
    const task = await taskService.createTask({ title: 'Buy groceries' });

    expect(task.id).toBeDefined();
    expect(task.title).toBe('Buy groceries');
    expect(task.status).toBe('pending');
    expect(task.createdAt).toBeInstanceOf(Date);
  });
});

步骤 2：GREEN，让它通过

编写最少代码让测试通过。不要过度工程化：

// GREEN: Minimal implementation
export async function createTask(input: { title: string }): Promise<Task> {
  const task = {
    id: generateId(),
    title: input.title,
    status: 'pending' as const,
    createdAt: new Date(),
  };
  await db.tasks.insert(task);
  return task;
}

步骤 3：REFACTOR，清理

测试保持绿色后，在不改变行为的前提下改进代码：

• 抽取共享逻辑
• 改进命名
• 移除重复
• 必要时优化

每个重构步骤后都运行测试，确认没有破坏任何东西。

Prove-It Pattern（Bug 修复）

收到 bug 报告时，不要从尝试修复开始。 先写一个能复现它的测试。

Bug report arrives
       │
       ▼
  Write a test that demonstrates the bug
       │
       ▼
  Test FAILS (confirming the bug exists)
       │
       ▼
  Implement the fix
       │
       ▼
  Test PASSES (proving the fix works)
       │
       ▼
  Run full test suite (no regressions)