Как добавлять тесты к унаследованному коду?

Question

Accepted Answer

**Унаследованный код** (часто не покрытый тестами, трудноизменяемый код) сложно тестировать — он может иметь запутанные зависимости и отсутствие тестов. Безопасное добавление тестов включает методы, такие как **тесты характеризации**, **швы** для разрыва зависимостей и пошаговое улучшение, обеспечивающие более безопасные изменения.

## Проблема унаследованного кода

```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.
```

## Тесты характеризации (зафиксировать текущее поведение)

```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.
```

## Разрыв зависимостей (швы)

```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
```

## Почему это важно

Понимание того, как добавлять тесты к унаследованному коду, — это ценное знание уровня senior, так как **большая часть реальной работы включает существующий, часто не покрытый тестами код**, а его безопасное улучшение — это частая и важная задача, поэтому это практически релевантно.

Унаследованный код (не покрытый тестами, тесно связанный, трудноизменяемый) представляет реальную **проблему курицы и яйца**: чтобы изменять его безопасно, нужны тесты, но его сложно тестировать (запутанные зависимости, не разработан для тестирования) — и изменение не покрытого тестами кода опасно, так как вы не можете определить, что-то ли вы сломали.

Понимание методов для решения этой проблемы — ценное практическое знание. **Тесты характеризации** (фиксирование *текущего* поведения кода как есть, утверждение того, что оно на самом деле делает, а не то, что должно делать — даже если это не полностью понято) обеспечивают **сетку безопасности**, которая позволяет рефакторить и изменять с уверенностью в том, что существующее поведение сохранено — ключевой метод для работы с кодом, который вы не полностью понимаете.

Понимание **разрыва зависимостей через швы** (поиск или создание мест для подстановки зависимостей, использование минимальных безопасных рефакторов для того, чтобы сделать сложный для тестирования код тестируемым — методы из работы Michael Feathers'а по унаследованному коду) необходимо для того, чтобы подвести сложный для тестирования код под тесты.

Понимание **пошагового подхода** — добавление тестов вокруг кода перед его изменением (сетка безопасности для изменения), сосредоточение на областях, которые изменяются, или высокорисковых/высокоценных областях (не на всей кодовой базе сразу), и пошаговое улучшение (правило бойскаута) — отражает практический, реалистичный способ улучшения унаследованных систем с течением времени.

Поскольку большая часть разработки в реальном мире включает существующий, часто не покрытый тестами унаследованный код, который должен быть изменен безопасно (частая, сложная ситуация), и поскольку понимание методов (тесты характеризации для сетки безопасности, швы для разрыва зависимостей, пошаговое улучшение) позволяет это сделать, понимание того, как добавлять тесты к унаследованному коду, — это ценное знание уровня senior — практически релевантное для обычной реальности работы с существующим не покрытым тестами кодом, отражающее опыт и методы, необходимые для безопасного улучшения унаследованных систем, важная компетенция для инженеров senior-уровня, которым часто необходимо сделать не покрытый тестами код более безопасным для изменений.