테스트 커버리지(test coverage)란 무엇인가요?

Question

Accepted Answer

**테스트 커버리지(test coverage)**는 코드 중 **테스트에 의해 실행되는** 비율을 측정합니다 — 보통 백분율로(예: 80% 커버리지). 테스트되지 않은 코드를 찾는 데 유용한 지표지만, 그 한계를 이해하는 것이 중요합니다. 높은 커버리지가 좋은 테스트를 보장하지는 않습니다.

## 커버리지가 측정하는 것

```text
테스트 커버리지 = 테스트 스위트가 실행하는 코드의 비율:
  라인 커버리지 → 테스트가 실행한 코드 라인의 %
  브랜치 커버리지 → 거친 브랜치(if/else 경로)의 %
  함수 커버리지 → 호출된 함수의 %
  구문(statement) 커버리지 → 실행된 구문의 %
→ 커버리지 도구는 코드를 계측하고 테스트가 무엇을 실행/미실행하는지 보고한다.
```

## 커버리지가 유용한 이유

```text
✓ 테스트되지 않은 코드 발견 — 낮은 커버리지 영역이 테스트가 부족한 곳을 드러냄 (틈새 발견)
✓ 측정 가능한 품질 신호; 시간 경과에 따라 추적; 많은 팀이 목표 설정 (예: ≥80%)
✓ 테스트가 놓친 브랜치/경로/오류 케이스 강조
```

## 한계 (중요!)

```text
⚠️ 높은 커버리지 ≠ 좋은 테스트:
  → 커버리지는 코드가 실행되었음을 보여줄 뿐, 동작이 올바르게 검증되었음을 보여주지 않음
  → 의미 있는 어서션 없이 코드를 실행 가능 → 100% 커버리지, 그러나 아무것도 검증 안 함
  → 100% 커버리지여도 버그를 놓칠 수 있음 (테스트 안 된 입력 조합, 로직 오류)
⚠️ 커버리지 숫자를 쫓기 → 목표 달성만을 위해 가치 낮은 테스트 작성
→ 커버리지는 유용한 가이드(틈새 발견)이지 품질 보장이 아니다. 현명하게 사용하라;
  백분율 달성이 아니라 중요한 동작을 잘 테스트하는 데 집중하라.
```

## 왜 중요한가

한계를 포함해 테스트 커버리지를 이해하는 것은 가치가 있습니다. 이는 올바르게 이해하면 유용하지만 잘못 사용하면 오해를 부르는 **흔히 쓰이는 지표**이므로 중요한 실용 지식입니다.

커버리지는 **코드 중 얼마나 많은 부분이 테스트에 의해 실행되는지**(라인, 브랜치, 함수, 구문 커버리지를 통한 백분율) 측정하며, 이를 이해하는 것이 유용한 이유는 **테스트되지 않은 코드를 발견**하고(테스트가 부족한 틈새를 드러냄 — 무엇을 테스트해야 하는지 식별하는 귀중한 방법), 팀이 추적할 수 있는 측정 가능한 품질 신호를 제공하며, 놓친 브랜치와 오류 케이스를 강조하기 때문입니다.

많은 팀이 커버리지를 목표가 있는 품질 지표로 사용합니다.

그러나 **한계를 이해하는 것이 결정적으로 중요합니다**. **높은 커버리지는 좋은 테스트와 같지 않습니다** — 커버리지는 코드가 *실행되었음*을 보여줄 뿐 그 동작이 올바르게 *검증되었음*을 보여주지 않으므로, 의미 없는 테스트로 높은(심지어 100%) 커버리지를 가질 수 있고(적절한 어서션 없이 코드를 실행하면 아무것도 검증하지 않음), 완전한 커버리지여도 버그를 놓칠 수 있습니다(테스트 안 된 입력 조합, 로직 오류).

**커버리지 숫자를 쫓는** 위험(목표 달성만을 위해 가치 낮은 테스트 작성)은 실제 안티패턴입니다.

**커버리지가 틈새를 찾는 유용한 가이드이지 품질 보장이 아니라는 점** — 그리고 백분율 달성이 아니라 중요한 동작을 잘 테스트하는 데 초점을 맞춰야 한다는 점 — 을 이해하는 것은, 커버리지를 도구가 아닌 목표로 취급하는 흔한 실수를 피하는 성숙한 판단을 반영합니다.

커버리지는 진정으로 유용하지만(테스트되지 않은 코드 발견) 흔히 오해되고 오용되는(품질 보장으로 취급되거나 게이밍할 목표로 취급됨) 널리 쓰이는 지표이고, 그 가치와 중요한 한계를 모두 이해하는 것이 현명하게 사용하게 해주므로, 테스트 커버리지를 이해하는 것은 가치 있고 실용적인 지식입니다. 이는 올바르게 이해해야 하는 유용한 지표로서, 그 한계(커버리지 ≠ 품질)를 이해하는 것이 지표 자체만큼 중요하며, 건전한 테스팅 판단을 반영합니다.