레거시 코드에 테스트를 어떻게 추가하나요?

Question

Accepted Answer

**레거시 코드**(흔히 테스트가 없고, 변경하기 어려운 코드)는 테스트하기 까다롭습니다 — 얽힌 의존성과 테스트가 없을 수 있습니다. 안전하게 테스트를 추가하는 것은 **특성화 테스트(characterization test)**, 의존성을 끊는 **이음새(seam)**, 점진적 개선 같은 기법을 포함하며, 더 안전한 변경을 가능하게 합니다.

## 레거시 코드의 과제

```text
레거시 코드는 흔히: 테스트 없음, 강하게 결합됨, 이해하기 어려움, 변경 위험:
  → 테스트 없음 → 변경이 위험 (무언가 깨뜨렸는지 알 수 없음)
  → 테스트 어려움 → 의존성이 얽힘 (unit 격리 불가); 테스트를 위해 설계되지 않음
→ 닭과 달걀 문제: 안전하게 변경하려면 테스트가 필요한데, 테스트하기 어렵다.
```

## 특성화 테스트 (현재 동작을 고정)

```text
특성화(골든 마스터) 테스트 → 코드의 현재 동작을 있는 그대로 포착
  (완전히 이해하지 못하거나 / 버그가 있어도):
  → 그것이 실제로 지금 하는 것을 단언하는 테스트 작성 → 안전망
  → 그러면 동작이 보존된다는 자신감으로 리팩터링/변경 가능
→ 해야 할 것이 아니라 하는 것을 단언 — 회귀로부터 보호하기 위해.
```

## 의존성 끊기 (이음새)

```text
테스트 어려운 코드를 격리하려면, 의존성을 대체할 곳인 이음새(SEAM)를 찾거나 만든다:
  → 의존성을 인터페이스 뒤로 추출; 주입; 코드를 테스트 가능하게 만드는
    가장 작고 안전한 리팩터링 사용 (Michael Feathers의 기법)
  → 의존성을 신중히 끊어 코드를 테스트 하에 두고, 테스트한 다음, 리팩터링
```

## 점진적 접근

```text
✓ 변경하기 전에 코드 주위에 테스트 추가 (변경을 위한 안전망)
✓ 변경하는 / 고위험 / 고가치 영역에 집중 (한 번에 전체 코드베이스가 아님)
✓ 점진적으로 개선 — 매번 코드를 조금씩 더 낫게 ("보이스카우트 규칙")
✓ 특성화 테스트로 동작을 포착한 뒤, 테스트 가능성을 향해 리팩터링
```

## 왜 중요한가

레거시 코드에 테스트를 추가하는 방법을 이해하는 것은 가치 있는 시니어 레벨 지식입니다. **대부분의 실제 작업은 기존의, 흔히 테스트되지 않은 코드를 다루며**, 그것을 안전하게 개선하는 것이 흔하고 중요한 과제이므로 실용적으로 관련성이 높습니다.

레거시 코드(테스트 없음, 강하게 결합됨, 변경 어려움)는 실제 **닭과 달걀 문제**를 제시합니다: 안전하게 변경하려면 테스트가 필요한데, 테스트하기 어렵습니다(얽힌 의존성, 테스트를 위해 설계되지 않음) — 그리고 테스트되지 않은 코드를 변경하는 것은 무언가 깨뜨렸는지 알 수 없으므로 위험합니다.

이를 해결하는 기법을 이해하는 것이 가치 있는 실용 지식입니다. **특성화 테스트**(코드의 *현재* 동작을 있는 그대로 포착, 해야 할 것이 아니라 실제로 하는 것을 단언 — 완전히 이해하지 못해도)는 기존 동작이 보존된다는 자신감으로 리팩터링하고 변경하게 해주는 **안전망**을 제공합니다 — 완전히 이해하지 못하는 코드를 다루는 핵심 기법입니다.

**이음새를 통한 의존성 끊기**(의존성을 대체할 곳을 찾거나 만들고, 얽힌 코드를 테스트 가능하게 만드는 최소의 안전한 리팩터링 사용 — Michael Feathers의 레거시 코드 작업에서 나온 기법)를 이해하는 것은 테스트하기 어려운 코드를 테스트 하에 두는 데 필수적입니다.

**점진적 접근** — 변경하기 전에 코드 주위에 테스트 추가(변경을 위한 안전망), 변경되는 또는 고위험/고가치 영역에 집중(한 번에 전체 코드베이스가 아님), 점진적으로 개선(보이스카우트 규칙) — 을 이해하는 것은 레거시 시스템을 시간에 걸쳐 개선하는 실리적이고 현실적인 방식을 반영합니다.

대부분의 실제 개발은 안전하게 변경되어야 하는 기존의 흔히 테스트되지 않은 레거시 코드를 다루고(흔하고 까다로운 상황), 기법(안전망을 위한 특성화 테스트, 의존성을 끊는 이음새, 점진적 개선)을 이해하는 것이 이를 가능하게 하므로, 레거시 코드에 테스트를 추가하는 방법을 이해하는 것은 가치 있는 시니어 레벨 지식입니다. 이는 기존 테스트되지 않은 코드를 다루는 흔한 현실에 실용적으로 관련이 있고, 레거시 시스템을 안전하게 개선하는 데 필요한 경험과 기법을 반영하는, 테스트되지 않은 코드를 변경하기 더 안전하게 만들어야 하는 시니어 엔지니어의 중요한 역량입니다.