レガシーコードにテストを追加するにはどうしますか？

Question

Accepted Answer

**レガシーコード**（テストされていない、変更が難しいコード）のテストは課題です。テストされていない可能性があり、依存関係が複雑で、テストが存在しないかもしれません。テストを安全に追加するには、**characterization テスト**、依存関係を破るための**seams**、段階的な改善などの技法を使用します。これにより、より安全に変更できるようになります。

## レガシーコードの課題

```text
Legacy code is often: untested, tightly coupled, hard to understand, risky to change:
  → no tests → changing it is dangerous (you can't tell if you broke something)
  → hard to test → dependencies are tangled (can't isolate units); not designed for testing
→ a chicken-and-egg problem: to change safely you need tests, but it's hard to test.
```

## Characterization テスト（現在の動作を固定）

```text
CHARACTERIZATION (golden master) tests → capture the code's CURRENT behavior as-is
  (even if you don't fully understand it / it has bugs):
  → write tests asserting what it ACTUALLY does now → a SAFETY NET
  → then you can refactor/change with confidence that behavior is preserved
→ Don't assert what it SHOULD do — assert what it DOES, to protect against regressions.
```

## 依存関係の破断（seams）

```text
To isolate hard-to-test code, find/create SEAMS (places to substitute dependencies):
  → extract dependencies behind interfaces; inject them; use the smallest safe refactors
    to make code testable (Michael Feathers' techniques)
  → carefully break dependencies so you can get the code under test, then test, then refactor
```

## 段階的なアプローチ

```text
✓ Add tests AROUND code BEFORE changing it (a safety net for the change)
✓ Focus on areas you're CHANGING / high-risk / high-value (not the whole codebase at once)
✓ Improve incrementally — leave code a bit better each time (the "boy scout rule")
✓ Use characterization tests to capture behavior, then refactor toward testability
```

## なぜ重要なのか

レガシーコードにテストを追加する方法を理解することは、価値あるシニアレベルの知識です。**実際の仕事のほとんどは既存で、テストされていないことが多いコードに関わる**ため、安全にそれを改善することは一般的で重要な課題であり、実践的に関連性があるからです。

レガシーコード（テストされていない、密結合で変更が難しい）は、実際の**鶏と卵のジレンマ**を提示します。安全に変更するにはテストが必要ですが、テストが難しい（複雑な依存関係、テストのために設計されていない）のです。また、テストされていないコードを変更することは危険です。何を壊したかわからないからです。

この問題に対処するための技法を理解することは、価値ある実践的な知識です。**Characterization テスト**（コードの*現在の*動作をそのままキャプチャし、完全に理解していなくても、実際に何をするかを表明する）は、既存の動作が保持されていることに確信を持ってリファクタリングと変更ができる**安全網**を提供します。これは、完全には理解していないコードを処理するための重要な技法です。

**seams を介した依存関係の破断**（依存関係を置き換える場所を見つけるか作成し、最小限の安全なリファクタリングを使用して複雑なコードをテスト可能にする — Michael Feathers のレガシーコード作業の技法）を理解することは、テストが難しいコードをテスト下に置くために不可欠です。

**段階的なアプローチ**を理解する — 変更前にコードの周りにテストを追加する（変更の安全網）、変更中の領域または高リスク/高価値の領域に焦点を当てる（コード全体ではなく）、段階的に改善する（ボーイスカウト・ルール）— は、既存のレガシー・システムを時間とともに改善する実用的でリアルな方法を反映しています。

ほとんどの実際の開発は、安全に変更する必要がある既存で、しばしばテストされていないレガシーコードに関わるため（一般的で課題の多い状況）、そして技法を理解する（安全網のための characterization テスト、依存関係を破るための seams、段階的改善）ことで、これが可能になるため、レガシーコードにテストを追加する方法を理解することは、価値あるシニアレベルの知識です。これは、既存のテストされていないコードを扱うという一般的な現実に対して実践的に関連しており、レガシー・システムを安全に改善するために必要な経験と技法を反映し、テストされていないコードをより安全に変更する必要があるシニアエンジニアにとって重要な能力です。