TDD테스트 주도 개발 · Test-Driven Development
실패하는 테스트 하나를 먼저 쓰고, 그 테스트를 통과할 만큼만 코드를 고친 뒤 테스트를 그대로 둔 채 구조를 다듬는 주기를 몇 분 단위로 되풀이하는 개발 방식이다.
1요약
- TDD 는 실패하는 테스트를 먼저 쓰고, 통과할 만큼만 코드를 고친 뒤 구조를 다듬는 개발 방식으로, Kent Beck 이 1990년대 말 XP 에서 만들어 2002년 책으로 정리했으며
unittest· JUnit 같은 xUnit 계열 테스트 도구 위에서 돈다. - 테스트를 나중에 몰아 쓰면 일정 끝에 빠지거나 이미 짠 코드의 출력을 기대값으로 옮겨 적기 쉬운데, Microsoft · IBM 네 팀 사례에서는 TDD 도입 뒤 출시 전 결함 밀도가 비슷한 프로젝트보다 40 ~ 90% 낮았고 초기 개발 시간은 15 ~ 35% 늘었다(Nagappan 2008 표 3).
- 「TDD 를 했는데 효과가 없다」는 한 바퀴의 크기로 가른다 — 테스트 여러 개를 한꺼번에 쓰고 한꺼번에 통과시켰으면 주기를 돈 것이 아니고, 새 테스트가 처음부터 통과했으면 그 테스트는 아무것도 재지 않았다.
2등장 배경
기능을 다 만든 뒤 테스트를 쓰면 테스트 작성이 일정 끝으로 밀려 빠지기 쉽고, 남은 테스트도 이미 짠 코드가 내는 값을 기대값으로 옮겨 적게 된다. 그러면 테스트가 통과해도 요구를 확인한 것인지 구현을 다시 읽은 것인지 가릴 수 없다.
Kent Beck 은 1990년대 말 XP(Extreme Programming)의 실천으로 테스트를 먼저 쓰는 방식을 만들었고(Fowler 2023 · XP 2판은 「Test-First Programming」이라 부름), 2002년 11월 『Test-Driven Development: By Example』에서 빨강 · 초록 · 리팩터 주기를 Money 예제와 xUnit 직접 구현 예제 두 사례로 정리했다(Beck 2002 1 · 2부). 2006년 3월 Dan North 는 테스트 이름을 「should」 문장으로 바꾸고 Given · When · Then 시나리오를 더해 BDD 를 내놓았고(North 2006), Fit · FitNesse 가 널리 쓰인 2003 ~ 2004년 무렵 고객 관점의 인수 테스트를 먼저 쓰는 ATDD 가 퍼졌다(Agile Alliance ATDD).
2023년 12월 Beck 은 테스트를 목록으로만 먼저 적고 한 번에 하나씩 테스트로 바꾸는 순서를 「Canon TDD」로 다시 적어, 목록 전부를 한꺼번에 테스트로 만드는 흔한 오용을 바로잡았다(Beck 2023). 지금 TDD 는 리팩터링의 안전망이자, CI 에서 커밋마다 도는 단위 테스트 스위트를 만드는 방법으로 쓰인다.
3쉽게 이해하기 — 서랍 틀부터 짜는 목수
가구 공방의 목수가 주문 메모에 「서랍 폭 40cm」 같은 요구를 다섯 줄 적는다. 첫 줄만 골라 그 치수의 나무 틀부터 짜고, 아직 깎지 않은 서랍을 넣어 보아 안 들어가는 것을 눈으로 확인한다. 들어갈 만큼만 깎아 틀을 통과시킨 뒤, 틀은 그대로 둔 채 거친 면을 다듬고 다시 넣어 본다. 메모 첫 줄을 지우고 다음 줄로 넘어가며, 일하다 떠오른 요구는 메모 끝에 덧붙인다.
그림 1 · 목수는 메모 한 줄을 틀로 먼저 짜고, 안 들어가는 것을 본 뒤 깎고, 틀은 그대로 둔 채 다듬고, 다음 줄로 넘어간다.
그림 2 · 틀은 세 단계 내내 그대로이고, 단계마다 바뀌는 것은 하나뿐이다 — 서랍 크기, 맞춤, 겉모양 순서.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 주문 메모 | 테스트 목록 | 만들 동작을 시나리오 한 줄씩 적고, 작업 중 떠오른 경우를 덧붙인다 |
| 치수 틀 | 단위 테스트(단언) | 기대값을 코드로 고정해 통과 · 실패를 기계가 판정한다 |
| 안 들어가는 서랍 | 빨강 — 실패 확인 | 새 테스트가 실패하는 것을 먼저 보아 테스트가 실제로 재는지 확인한다 |
| 들어갈 만큼만 깎기 | 초록 — 최소 구현 | 지금 테스트를 통과하는 가장 작은 변경만 한다(상수 반환도 허용) |
| 틀은 둔 채 다듬기 | 리팩터 | 테스트 기대값을 그대로 둔 채 중복 · 이름 · 구조를 고친다 |
| 목수 한 사람 | 개발자 | 한 바퀴를 몇 분 안에 돌며 세 단계를 섞지 않는다 |
| 메모 줄 지우기 | 목록 갱신 | 통과한 시나리오를 지우고 목록이 빌 때까지 되풀이한다 |
⚠ 비유가 맞지 않는 곳: 나무 틀은 그 서랍을 잴 때만 쓰지만, 테스트는 남아서 이후 모든 변경마다 함께 다시 돈다 — 그래서 TDD 로 쌓은 테스트 스위트는 그대로 회귀 테스트가 되고, 치수 하나가 아니라 입력 · 예외 · 의존 대상의 응답까지 고정한다.
4구조 — 테스트 목록 · 단위 테스트 · 테스트 더블
TDD 는 새 도구를 만들지 않고 xUnit 계열 테스트 도구의 요소를 정해진 순서로 쓴다. 한 테스트는 준비 · 실행 · 단언으로 이뤄지고(Beck 2023 2단계), 시험 대상 코드가 시계 · DB · 망처럼 느리거나 값이 바뀌는 대상에 의존하면 그 의존을 테스트 더블로 바꿔 끼운다(Fowler 2007).
그림 3 · 테스트 목록에서 고른 테스트 하나가 시험 대상 코드를 부르고, 느린 의존은 테스트 더블로 바꾸며, 러너의 결과가 다음 손을 정한다.
| 요소 | 역할 | 값(사례) | 근거 |
|---|---|---|---|
| 테스트 목록 | 만들 동작의 시나리오 목록 · 한 번에 하나만 테스트로 | 5줄 | Beck 2023 1단계 |
| 단위 테스트 | 동작 하나를 기대값으로 고정 | assertEqual(parse_duration("45s") | unittest 문서 |
| 테스트 러너 | 테스트를 모아 실행 · 요약 | python -m unittest -v → OK · FAILED (failures=1) | unittest 문서 |
| 시험 대상 코드 | 테스트가 부르는 공개 함수 | duration.py 의 parse_duration() | 사례 |
| 테스트 더블 | 느린 · 값이 바뀌는 의존을 대신함 | Dummy · Stub · Spy · Mock · Fake | Fowler 2007 · unittest.mock 문서 |
| 실행 결과 | 다음 손을 정함 | 실패(failure) = 단언 불일치 · 오류(error) = 그 밖의 예외 | unittest 문서 |
| 리팩터링 | 통과한 상태에서 구조 정리 | 상수 추출 · 한 줄로 합침 | Beck 2002 31장 |
다섯 더블 가운데 Stub 은 정해 둔 답을 돌려주기만 하고, Spy 는 받은 호출을 기록해 두며, Mock 만 받을 호출을 미리 기대값으로 정해 행동을 검증한다(Fowler 2007). Python unittest.mock 의 Mock 은 먼저 실행하고 나중에 assert_called_once_with() 로 확인하는 「실행 → 단언」 방식이다(unittest.mock 문서).
5동작 — 시간 문자열 함수를 테스트 다섯 개로 키우는 사례
사례 = 직접 실행(Python 3.14.0 · 표준 라이브러리 unittest · re · python -m unittest -v). 함수 parse_duration(text) 는 「1h30m」 같은 시간 문자열을 초 수로 바꾼다.
- 테스트 목록 — 「45s → 45」 · 「2m → 120」 · 「1h30m → 5400」 · 「빈 문자열 → ValueError」 · 「90x → ValueError」 다섯 줄을 적는다. 테스트 코드는 아직 하나도 없다.
- 첫 빨강 · 가짜 구현 —
test_seconds하나를 쓰고return None뿐인 함수로 돌리면FAILED (failures=1)·None != 45다.return 45한 줄로 바꾸자Ran 1 test … OK가 된다(Beck 2002 28장 Fake It). - 삼각측량 —
test_minutes(「2m」)를 더하면45 != 120으로 1개 실패 · 1개 통과다. 상수를 버리고 마지막 글자를 단위로 읽는 3줄 구현으로 바꿔 2개 통과 — 예가 둘이 된 뒤에야 일반화한다(Triangulate). - 오류로 나는 빨강 —
test_hours_and_minutes(「1h30m」)는 단언에 닿기 전에int("1h30")이ValueError를 내FAILED (errors=1)로 끝난다(단언 밖 예외 = 오류 · unittest 문서).re.로 조각을 모아 더하는 6줄 구현으로 3개 통과.findall(r"(\d+)([hms])", text) - 리팩터 — 단위 표를
UNIT_SECONDS상수로, 정규식을PART로 빼고 합계를sum()한 줄로 줄인다. 생산 코드 6 → 5줄 · 테스트 3개와 기대값은 손대지 않고OK. - 입력 거부 —
test_empty_rejected는 빈 문자열에 0 이 돌아와ValueError not raised로 실패한다. 문자열 전체가(?:\d+[hms])+꼴인지fullmatch()로 먼저 보고 아니면ValueError를 내게 해 4개 통과(생산 코드 8줄). - 바로 통과한 테스트 — 목록 마지막 「90x」 테스트는 넣자마자 5개 모두 통과했다. 6단계의
fullmatch()가 이미 막은 입력이라, 6단계 전 코드로 돌려 0 이 돌아오는 것(= 이 단언이 실패할 수 있음)을 확인하고 목록을 비운다 — 실행 10번 · 빨강 4번 · 테스트 5개 · 생산 코드 8줄.
그림 4 · 실행 10번 동안 빨강은 늘 새 테스트 하나에서만 났고, 리팩터와 마지막 실행은 테스트를 하나도 깨지 않았다.
🔑 테스트는 «먼저 실패하는 것을 본» 뒤에야 통과가 뜻을 갖는다 — 처음부터 초록인 테스트는 코드보다 테스트 자신을 먼저 의심한다.
그림 5 · 빨강에서는 테스트만, 초록에서는 생산 코드만, 리팩터에서는 구조만 바꾸고, 리팩터 중 실패하면 고치지 않고 직전 초록으로 되돌린다.
🔑 초록으로 가는 동안은 동작만, 리팩터 동안은 구조만 바꾼다 — 한 단계에서 둘을 섞으면 테스트가 깨졌을 때 어느 변경이 깨뜨렸는지 가릴 수 없다.
6비교 — 테스트 후작성 · ATDD · BDD 와의 차이
| 기준 | TDD | 테스트 후작성 | ATDD | BDD |
|---|---|---|---|---|
| 먼저 쓰는 것 | 단위 테스트 1개 | 생산 코드 | 인수 테스트(요구 예시) | 행동 시나리오(Given · When · Then) |
| 쓰는 사람 | 개발자 | 개발자 · 테스터 | 고객 · 개발 · 테스트 관점 셋이 함께(Agile Alliance ATDD) | 개발자 + 업무 분석가(North 2006) |
| 단위 · 한 바퀴 | 함수 · 클래스 · 몇 분 | 기능 하나 · 구현 끝 | 사용자 이야기 하나 | 기능의 시나리오 하나 |
| 테스트의 말 | 코드 · 단언 | 코드 · 단언 | 업무 예시 표 | 업무 문장 · 「should」 이름 |
| 대표 도구 | xUnit(unittest · JUnit) | xUnit · 커버리지 도구 | Fit · FitNesse | JBehave(North 2006) |
분석요구 자체가 흔들리면 ATDD · BDD 로 고객과 예시를 먼저 맞추고, 그 예시를 구현하는 안쪽 고리로 TDD 를 돈다 — 셋은 대안이라기보다 바깥 · 안쪽 고리다. 근거는 표의 「단위 · 한 바퀴」 행과, ATDD 가 TDD 를 본떠 만든 방식이라는 정의(Agile Alliance ATDD)다.
효과 연구는 결과가 갈린다. 산업 네 팀 사례(Nagappan 2008)는 결함 밀도 40 ~ 90% 감소와 개발 시간 15 ~ 35% 증가를 보였지만 비교 대상이 «비슷한 다른 프로젝트»인 사례 연구이고, 27편 메타 분석(Rafique 2013)은 품질 개선은 작고 생산성 효과는 거의 없으며 산업 연구에서만 품질 향상과 생산성 하락이 함께 크다고 정리했다. 전문가 39명의 작업 82건을 본 Fucci 2017 은 테스트를 먼저 쓰는가(순서)는 품질 · 생산성과 뚜렷한 관련이 없고, 단계가 잘고 고른가가 관련이 있다고 보고했다.
분석도입 효과를 따질 때는 «테스트를 먼저 썼는가»보다 «한 바퀴가 몇 분 안에 고르게 도는가»를 잰다. 근거는 Fucci 2017 의 순서 · 잘게 나뉨 결과와, 연구 환경(산업 · 학교)에 따라 효과 크기가 달랐던 Rafique 2013 이다.
7실무 진단 — TDD 가 효과를 내지 못하는 원인 가르기
분석커밋 기록에서 테스트 파일과 생산 코드가 함께 조금씩 바뀌는지부터 본다. 한 바퀴가 작고 고른가가 효과와 관련 있으므로(Fucci 2017) 주기가 깨졌는지를 먼저 가르고, 그다음 테스트 하나하나의 질을 본다.
| # | 증상 | 의심 원인 | 단계 | 확인 명령 · 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 새 테스트 수십 개가 한 커밋에 들어오고 한동안 빨강 | 목록 전부를 테스트로 먼저 바꿈 | 테스트 목록 | git log --stat -- tests/ | 새 테스트는 한 번에 하나 · 빨강도 하나(Beck 2023 흔한 실수) |
| 2 | 새 테스트가 처음부터 통과 | 단언 없음 · 이미 있는 동작 | 빨강 | 고치기 전 코드에서 python -m unittest -v -k <테스트 이름> | 고치기 전 코드에서 FAIL 이 나와야 함(Beck 2023 2단계 · 사례 7단계) |
| 3 | 기대값이 늘 실제 출력과 같은 꼴 | 실행 결과를 기대값에 붙여 넣음 | 빨강 | 테스트 diff 의 기대값 ↔ 요구 문서 | 기대값은 요구에서 따로 계산(Beck 2023 흔한 실수) |
| 4 | 리팩터 뒤 테스트 여러 개가 함께 깨짐 | 테스트가 내부 호출 순서 · 비공개 함수에 묶임 | 리팩터 | git diff -- tests/ · assert_called_* 개수 | 공개 동작은 같은데 호출 검증만 깨지면 테스트가 구현에 묶임(Fowler 2007 행동 검증) |
| 5 | 테스트가 느려 자주 돌리지 않음 | DB · 망 · 시계를 실제로 부름 | 초록 | python -m unittest --durations 5 | 느린 테스트의 의존을 Fake · Stub 으로 바꿈(unittest 문서 · 3.12 이후 옵션) |
커밋 기록부터 보는 까닭은 1행이 맞으면 나머지 행을 볼 필요 없이 주기를 다시 세우는 것으로 끝나기 때문이다. 주기가 맞는데도 효과가 없으면 2 · 3행으로 테스트가 실제로 재는지 보고, 마지막에 4 · 5행으로 테스트가 구현에 묶였거나 느린지를 본다.
8시험 대비
www.q-net.or.kr시험에서는 개념 · 주기 · 장단점을 묻는 정의 · 특징형과, 기존 개발 과정에 TDD 를 들이는 절차와 걸림돌을 묻는 구현 · 설계형이 나올 수 있다. 정의형은 주기 상태 그림과 BDD · ATDD 비교표로, 구현형은 사례 단계와 도입 걸림돌(느린 테스트 · 레거시 코드 · 테스트 더블) 대응으로 답안을 짠다.
- 개요 — 정의 · Beck 2002 · XP 의 테스트 우선 실천 · 목적(설계 피드백 · 회귀 안전망)
- 구성 요소 — 그림 3 구성도(테스트 목록 · 단위 테스트 · 러너 · 시험 대상 · 테스트 더블 5종) + 요소 표
- 절차 — 그림 5 빨강 · 초록 · 리팩터 상태 그림(단계별로 바꾸는 것 · 예외 길) + 가짜 구현 · 삼각측량
- 적용 사례 — 그림 4 실행 10번 결과(테스트 1 → 5개 · 실패와 오류 구분 · 바로 통과한 테스트 점검)
- 비교 — 비교표(TDD · 테스트 후작성 · ATDD · BDD — 먼저 쓰는 것 · 쓰는 사람 · 한 바퀴)
- 효과와 한계 — 결함 밀도 40 ~ 90% 감소 · 개발 시간 15 ~ 35% 증가(Nagappan 2008) · 27편 메타 분석 · 순서보다 잘게 나뉨(Fucci 2017)
꼭 쓸 키워드
빨강초록리팩터테스트 목록단위 테스트테스트 더블가짜 구현삼각측량회귀 안전망Canon TDD
다른 답안과 차이를 내는 한 가지는 효과 연구가 갈린다는 점을 숫자 두 쌍(40 ~ 90% · 15 ~ 35%)과 «순서보다 한 바퀴의 크기»라는 Fucci 2017 결과로 함께 적는 것이다.
9오해와 사실
- 오해TDD 는 테스트 케이스를 고르는 테스트 기법의 하나다.사실TDD 는 테스트로 개발을 이끄는 개발 방식이고(Fowler 2023), 동등 분할 · 경계값 같은 케이스 선택 규칙은 테스트 기법에서 가져다 쓴다.
- 오해TDD 는 필요한 테스트를 모두 먼저 쓴 뒤 구현하는 것이다.사실먼저 적는 것은 테스트 목록이고 테스트 코드는 한 번에 하나씩 쓰며, 목록 전체를 테스트로 먼저 바꾸는 것은 흔한 실수로 꼽힌다(Beck 2023).
- 오해테스트 더블은 모두 Mock 이다.사실테스트 더블은 Dummy · Fake · Stub · Spy · Mock 다섯이고, 그중 받을 호출을 미리 기대값으로 정해 행동을 검증하는 것은 Mock 하나다(Fowler 2007).
10핵심 정리
| 구분 | 바꾸는 것 | 그대로 두는 것 | 끝나는 조건 | 사례 값 | 근거 |
|---|---|---|---|---|---|
| 테스트 목록 | 시나리오 줄 | 생산 코드 | 목록이 빔 | 5줄 | Beck 2023 |
| 빨강 | 테스트 1개 추가 | 생산 코드 | 새 테스트만 실패 | None != 45 | Beck 2002 |
| 초록 | 생산 코드(가장 작게) | 테스트 | 전부 통과 | return 45 | Beck 2002 28장 |
| 리팩터 | 구조 · 이름 | 테스트 기대값 | 다시 전부 통과 | 6 → 5줄 | Fowler 2023 |
| 테스트 더블 | 의존 대상 | 시험 대상 코드 | 테스트가 빠르고 결과가 일정 | Stub · Mock · Fake | Fowler 2007 |
| ATDD · BDD | 바깥 고리(인수 기준 · 시나리오) | 안쪽 TDD 고리 | 인수 기준 통과 | Given · When · Then | North 2006 |
11참고 문헌
- 먼저 볼 문헌
- ★ Test-Driven Development: By Example (Kent Beck) — 빨강 · 초록 · 리팩터 주기와 Money · xUnit 두 사례를 원저로 볼 때
- ★ Canon TDD (Kent Beck) — 테스트 목록 → 하나씩 → 통과 → 리팩터 순서와 흔한 실수 목록을 볼 때
- ★ Realizing quality improvement through test driven development: results and experiences of four industrial teams (Nagappan · Maximilien · Bhat · Williams · Empirical Software Engineering 13(3) 289-302) — 산업 네 팀의 결함 밀도 · 개발 시간 변화 수치를 볼 때
- ★ A Dissection of the Test-Driven Development Process: Does It Really Matter to Test-First or to Test-Last? (Fucci · Erdogmus · Turhan · Oivo · Juristo · IEEE TSE 43(7)) — 테스트 우선 순서보다 단계의 잘게 나뉨 · 고름이 효과와 관련 있다는 결과를 볼 때
- ★ Mocks Aren't Stubs (Martin Fowler) — 테스트 더블 다섯 종류(Dummy · Fake · Stub · Spy · Mock)의 정의를 볼 때
- 본문 근거
- Test Driven Development (Martin Fowler bliki) — Martin Fowler · 2023-12 ·
martinfowler.com/bliki/TestDrivenDevelopment.html· 확인 2026-11-04 - The Effects of Test-Driven Development on External Quality and Productivity: A Meta-Analysis (Rafique · Mišić · IEEE TSE 39(6) 835-856) — IEEE · 2013-06 ·
doi.org/10.1109/TSE.2012.28· 확인 2026-11-04 - xUnit Test Patterns: Refactoring Test Code - Test Double (Gerard Meszaros) — Addison-Wesley · 2007-05 ·
martinfowler.com/books/meszaros.html· 확인 2026-11-04 - Introducing BDD (Dan North · Better Software 2006-03) — Dan North · 2006-09 ·
dannorth.net/blog/introducing-bdd/· 확인 2026-11-04 - Agile Alliance Glossary - Acceptance Test Driven Development (ATDD) — Agile Alliance · 2026-11 ·
agilealliance.org/glossary/atdd/· 확인 2026-11-04 - Python documentation - unittest: Unit testing framework — Python Software Foundation · 2026-11 ·
docs.python.org/3/library/unittest.html· 확인 2026-11-04 - Python documentation - unittest.mock: mock object library — Python Software Foundation · 2026-11 ·
docs.python.org/3/library/unittest.mock.html· 확인 2026-11-04