Refactoring리팩터링 · Refactoring
관찰 가능한 동작은 그대로 두고 코드의 내부 구조를 바꿔, 읽기 쉽고 고치는 비용이 적은 코드로 만드는 일이다. 작은 변환을 하나씩 적용하고 그때마다 테스트로 동작이 그대로인지 확인한다.
1요약
- 리팩터링은 Fowler 가 「관찰 가능한 동작을 바꾸지 않는 내부 구조 변경」으로 정의한 작업으로, 그 위에서 함수 추출 · 이름 바꾸기 같은 이름 붙은 변환이 한 번에 하나씩 적용되고 매번 테스트가 동작을 확인한다(Fowler refactoring.com).
- 구조를 정리하지 않은 코드는 기능 하나를 더할 때마다 추가 비용을 낸다 — Cunningham 은 1992년 이것을 기술 부채라 부르고, 덜 맞는 코드에 쓰는 시간을 그 부채의 이자라고 적었다(Cunningham 1992).
- 「리팩터링했더니 깨졌다」는 그 커밋에서 테스트 기대값이 바뀌었는가로 가른다 — 바뀌었으면 기능 변경이 섞인 것이고, 그대로인데 깨졌으면 테스트가 그 줄을 지나지 않은 안전망의 구멍이다.
2등장 배경
1980년대 객체지향 프레임워크는 쓰면서 클래스 계층을 여러 번 고쳐야 했는데, 손으로 메서드를 옮기다 호출부 하나를 놓치면 그 수정이 곧 결함이 됐다. Opdyke 는 1992년 박사 논문에서 동작을 보존하는 재구조화 연산을 refactoring 으로 이름 붙이고, 각 연산이 안전하려면 지켜야 할 사전 조건을 정리했다(Opdyke 1992). 같은 해 Cunningham 은 OOPSLA 경험 보고에서 처음 출하한 코드를 «빚을 지는 것»에 견주고, 빚은 다시 쓰기로 제때 갚아야 한다고 썼다(Cunningham 1992).
Fowler 는 1999년 Java 예제로 쓴 책에서 기법을 카탈로그로 묶었고, 18년 뒤 2018년 JavaScript 예제로 고쳐 펴냈다(Fowler refactoring.com · Fowler 2018). 지금은 편집기가 이름 바꾸기 · 추출 · 인라인을 기계적으로 대신하며, LSP 3.17 은 이 동작을 refactor.extract · refactor.inline · refactor.rewrite 종류로 표준화했다(LSP 3.17 CodeActionKind).
3쉽게 이해하기 — 영업 중에 정리하는 주방
점심 영업 중인 식당 주방에서 요리사가 같은 양념 통이 서랍 세 곳에 흩어져 있는 것을 본다. 손님이 받는 요리 맛은 바뀌면 안 되므로, 요리사는 먼저 메뉴마다 맛 기준표를 적고 통을 하나만 옮긴 뒤 바로 맛을 본다. 맛이 그대로면 다음 통을 옮기고, 달라지면 통을 원래 서랍에 돌려놓는다. 정리를 미룬 주방은 새 메뉴 하나를 넣을 때마다 통을 찾느라 시간이 더 든다.
그림 1 · 주방 정리는 손님이 받는 맛을 그대로 둔 채 통 하나씩 옮기고 맛보는 일이다 — 맛 기준표가 테스트, 통 옮기기가 변환 한 번이다.
그림 2 · 맛을 보니 셋째 서랍의 통은 다른 양념이었다 — 실제로도 테스트가 다른 동작을 찾아낸 계산은 합치지 않고 남긴다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 손님이 받는 맛 | 관찰 가능한 동작 | 같은 입력에 같은 출력 · 부작용을 내며, 리팩터링 전후로 바뀌지 않는다 |
| 흩어진 양념 통 | 코드 냄새 | 중복 코드 · 긴 함수처럼 구조를 손볼 곳을 알리는 신호다 |
| 맛 기준표 | 테스트 안전망 | 지금 동작을 고정해, 변환 뒤 달라진 것을 바로 알린다 |
| 통 하나 옮기기 | 리팩터링 기법 한 번 | 함수 추출 · 이름 바꾸기처럼 이름 붙은 작은 변환을 하나 적용한다 |
| 맛보기 | 테스트 실행 | 변환마다 전체 테스트를 돌려 모두 통과해야 다음으로 간다 |
| 원래 서랍으로 | 되돌리기 | 실패하면 고쳐 맞추지 않고 직전 커밋으로 돌린 뒤 더 작게 다시 한다 |
| 통 찾는 시간 | 기술 부채의 이자 | 구조가 나빠 기능 추가마다 더 드는 노력이다 |
| 통 옮기는 기계 | 자동 리팩터링 도구 | 편집기 · 언어 서버가 호출부까지 한 번에 고쳐 준다 |
⚠ 비유가 맞지 않는 곳: 맛보기는 요리사가 떠올린 메뉴만 확인하지만, 테스트도 작성한 경우만 확인하므로 «테스트 통과 = 동작 보존»은 테스트가 덮은 범위에서만 성립한다. 또 주방 정리는 영업과 따로 하지만, 리팩터링은 기능 추가 사이사이에 몇 분 단위로 끼워 넣는 것이 보통이다(Fowler 2014).
4구조 — 리팩터링 한 바퀴의 구성 요소
리팩터링 한 번은 냄새 · 기법 · 변환 · 테스트 네 요소가 도는 고리이고, 고리를 한 바퀴 돌 때마다 관찰 가능한 동작은 그대로다. Fowler 의 동사 정의도 «리팩터링(명사)을 여러 번 적용해 구조를 바꾸는 것»이라 한 바퀴가 작업의 단위가 된다(Fowler refactoring.com).
그림 3 · 냄새가 기법을 고르고, 변환 한 번마다 테스트가 판정해 통과하면 커밋 · 실패하면 되돌린다 — 이 고리를 여러 번 도는 것이 리팩터링이다.
| 요소 | 역할 | 예 · 값 | 근거 |
|---|---|---|---|
| 코드 냄새 | 구조를 손볼 곳을 알리는 신호 | Duplicated Code · Long Function · Feature Envy · Shotgun Surgery | Fowler 2018 3장 |
| 기법 | 이름과 절차가 정해진 변환 | Extract Function(옛 Extract Method) · Rename Variable · Inline Function · Move Function | Fowler 카탈로그 |
| 변환 한 번 | 동작을 지키는 가장 작은 코드 변경 | 커밋 하나 · 몇 분 단위 | Fowler refactoring.com |
| 테스트 안전망 | 변환마다 동작 보존을 판정 | 기존 동작을 고정하는 특성 테스트 | Feathers 2004 |
| 관찰 가능한 동작 | 지켜야 할 경계 | 공개 함수의 입력 · 출력 · 부작용 | Fowler refactoring.com |
| 사전 조건 | 변환이 안전한지 미리 확인 | 새 이름이 같은 범위에 없을 것 | Opdyke 1992 |
🔑 리팩터링은 «동작을 지킨 채 구조만 바꾼다»가 아니라 «테스트가 덮은 동작을 지킨 채 바꾼다»이다 — 안전망이 없는 코드에서는 첫 작업이 변환이 아니라 테스트 작성이다.
5동작 — 할인 계산 중복을 함수 하나로 모으는 사례
Python 주문 모듈의 order_total() 함수는 52줄이고, 회원 등급별 할인 계산 7줄이 세 곳에 되풀이된다(설명용 가정 값). 할인 규칙이 바뀌면 세 곳을 모두 고쳐야 하는 Shotgun Surgery 냄새다.
- 안전망 — 지금 동작을 고정하는 특성 테스트 12개를 쓰고,
coverage report -m의 Missing 열에order_total()줄이 하나도 없음을 확인한다(coverage.py report). - 이름 바꾸기 — 지역 변수
d를discount_rate로 바꾼다(Rename Variable · 편집기의 언어 서버textDocument/rename) · 테스트 12/12 통과 · 커밋 r1. - 함수 추출 — 첫째 할인 계산 7줄을
apply_discount(amount, grade)로 뽑는다(Extract Function) · 12/12 · 커밋 r2. - 한꺼번에 시도 — 둘째 · 셋째 계산을 한 번에 호출로 바꾸자 11/12 로 하나가 실패한다 → 고쳐 맞추지 않고
git restore order.py로 r2 상태로 되돌린다(git-restore). - 더 작게 — 둘째 계산만 바꾼다 · 12/12 · 커밋 r3.
- 다른 동작 발견 — 셋째 계산만 바꾸자 다시 하나가 실패한다(11/12) — 셋째 곳은 할인 전에 반올림을 하는 다른 동작이었다 → 되돌리고, 그 차이를 테스트 이름에 남긴다.
- 결과 —
order_total()31줄 +apply_discount()9줄 · 할인 규칙을 고칠 곳 3 → 2 · 테스트 12개는 처음과 같다. 새 등급 할인 요구는 이 뒤에 «기능 추가»로 따로 한다.
그림 4 · 변환마다 테스트 12개를 돌려 모두 통과한 셋만 커밋했고, 실패한 두 번은 되돌렸다 — 둘째 실패는 숨은 다른 동작을 찾아냈다.
리팩터링 중에는 테스트를 더하지도 고치지도 않고, 기능을 더할 때만 테스트가 는다. Kent Beck 은 이것을 «두 모자»라 불렀다 — 한 번에 한 모자만 쓰고, 모자를 바꿀 때를 스스로 안다(Fowler 2018 2장).
그림 5 · 리팩터링 구간에는 테스트 수가 수평이고, 테스트는 기능 추가 구간에서만 하나씩 늘며 새 테스트가 통과할 때까지만 실패가 있다.
🔑 실패한 변환은 고쳐 맞추지 않고 되돌린다 — 고쳐 맞추는 순간 그 커밋에 동작 변경이 섞여, 무엇이 동작을 바꿨는지 다시 가릴 수 없게 된다.
6비교 — 성능 최적화 · 재작성 · 기능 추가와의 차이
| 기준 | 리팩터링 | 성능 최적화 | 재작성 | 기능 추가 |
|---|---|---|---|---|
| 관찰 가능한 동작 | 그대로 | 그대로(결과는 같고 빨라짐) | 다시 정의할 수 있음 | 바뀜(새 동작) |
| 목표 지표 | 읽기 · 고치기 쉬움 | 시간 · 메모리 | 새 언어 · 새 구조 | 요구 충족 |
| 코드 결과 | 대개 더 읽기 쉬움 | 더 읽기 어려워질 때가 많음(Fowler 2018 2장) | 옛 코드를 버림 | 코드가 늚 |
| 작업 단위 | 몇 분짜리 변환 · 언제든 배포 가능 | 측정한 병목 한 곳 | 몇 달 · 끝날 때까지 배포 못 함 | 요구 하나 |
| 테스트 | 수 · 기대값 그대로 | 그대로 + 성능 측정 | 새로 만듦 | 먼저 늘림 |
분석동작은 맞는데 고치기 어려우면 리팩터링, 측정된 병목이 있으면 성능 최적화, 언어 · 플랫폼 자체를 바꿔야 하면 재작성 또는 재공학(Chikofsky 1990)이 맞다. 근거는 표의 「작업 단위」 행 — 리팩터링만이 중간에 멈춰도 배포 가능한 상태를 남기므로, 재작성을 고르기 전에 리팩터링으로 얼마나 갈 수 있는지 먼저 따져 본다.
7실무 진단 — 리팩터링 뒤 깨진 원인 가르기
분석리팩터링 커밋의 diff 에서 테스트 기대값이 바뀌었는지부터 본다. 정의상 리팩터링은 관찰 가능한 동작을 바꾸지 않으므로(Fowler refactoring.com), 기대값 변경이 있으면 기능 변경이 섞인 것이고 없으면 안전망 · 바깥 참조 쪽 문제다.
| # | 증상 | 의심 원인 | 단계 | 확인 명령 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 리팩터링 커밋 뒤 출력이 달라짐 | 두 모자를 함께 씀(기능 변경 섞임) | 변환 | git diff r2 r3 -- tests/ | 테스트 기대값 줄이 바뀜 = 리팩터링 아님(Fowler refactoring.com 정의) |
| 2 | 테스트는 통과했는데 운영에서 깨짐 | 바뀐 줄을 테스트가 지나지 않음 | 안전망 | coverage report -m | 바뀐 줄 번호가 Missing 열에 있음(coverage.py report) |
| 3 | 이름 바꾸기 뒤 실행 중 이름 오류 | 문자열 · 설정 · 리플렉션이 옛 이름을 씀 | 사전 조건 | git grep -n -w old_name | 코드 밖 파일 · 문자열에 옛 이름이 남음(git-grep) |
| 4 | 외부 팀 빌드가 깨짐 | 공개 API 이름을 바꿈 | 관찰 가능한 동작 | git grep -n -w old_name + 호출하는 저장소 목록 | 외부 호출자가 있으면 옛 이름을 새 함수에 위임하는 함수로 남김(Fowler 카탈로그 Change Function Declaration) |
안전망부터 보는 까닭은 통과한 테스트가 무엇을 덮었는지 모르면 나머지 판정을 믿을 수 없기 때문이다. 그다음 diff 로 두 모자가 섞였는지 보고, 둘 다 깨끗하면 코드 바깥에서 옛 이름을 찾는다.
8시험 대비
www.q-net.or.kr시험에서는 정의와 원칙(동작 보존 · 작은 단계 · 테스트)을 묻는 정의 · 특징형, 재공학 · 재작성 · 성능 최적화와 견주는 비교형이 나올 수 있다. 기술 부채를 함께 묻는 경우 부채가 생기는 원인 · 갚는 방법으로 리팩터링을 놓는다.
- 개요 — 정의(Fowler · 관찰 가능한 동작 불변) · Opdyke 1992 · 목적(이해 · 수정 비용)
- 구성 요소 — 그림 3 리팩터링 한 바퀴(냄새 → 기법 → 변환 → 테스트 → 커밋 · 되돌림) + 요소 표
- 절차 사례 — 그림 4 단계별 테스트 결과(이름 바꾸기 · 함수 추출 · 실패 뒤 되돌림)
- 원칙 — 그림 5 두 모자(리팩터링 중 테스트 수 그대로) · 작은 단계 · 테스트 안전망
- 비교 — 비교표(리팩터링 · 성능 최적화 · 재작성 · 기능 추가 — 동작 · 단위 · 테스트)
- 기술 부채와 도구 — Cunningham 1992 부채 · 이자 · 자동 도구(LSP refactor.extract · inline · rewrite)
꼭 쓸 키워드
관찰 가능한 동작코드 냄새함수 추출이름 바꾸기테스트 안전망특성 테스트두 모자기술 부채자동 리팩터링
다른 답안과 차이를 내는 한 가지는 그림 5 처럼 «리팩터링 구간에는 테스트 수가 수평»이라는 점을 그래프로 보이는 것이다.
9오해와 사실
- 오해코드를 정리하며 작은 버그 수정도 함께 하면 리팩터링이 빨라진다.사실버그 수정은 관찰 가능한 동작을 바꾸므로 리팩터링이 아니고, 같은 커밋에 섞으면 무엇이 동작을 바꿨는지 가릴 수 없다(Fowler refactoring.com · Fowler 2018 2장 두 모자).
- 오해리팩터링은 일정이 빌 때 따로 잡는 정리 작업이다.사실Fowler 는 리팩터링을 TDD · 줍기 · 이해 · 준비 · 계획 · 장기 여섯 흐름으로 나누며, 일정을 따로 잡는 «계획» 흐름은 그 여섯 가운데 하나일 뿐이다(Fowler 2014).
- 오해기술 부채는 대충 짠 코드를 가리키는 말이다.사실Cunningham 의 원래 은유는 첫 출하 코드처럼 그때의 이해로 쓴 코드도 포함하며, 빚 자체보다 «갚지 않을 때»를 위험으로 적었다(Cunningham 1992).
10핵심 정리
| 구분 | 맡는 일 | 바뀌는 것 | 그대로인 것 | 확인 방법 | 근거 |
|---|---|---|---|---|---|
| 코드 냄새 | 손볼 곳 알림 | — | — | 중복 · 긴 함수 · 흩어진 수정 | Fowler 2018 3장 |
| 기법 | 변환 이름 · 절차 | 구조 | 동작 | 카탈로그 이름 | Fowler 카탈로그 |
| 테스트 안전망 | 동작 보존 판정 | — | 테스트 수 · 기대값 | coverage report -m | Feathers 2004 |
| 작은 단계 | 실패 범위를 좁힘 | 커밋 하나 | 배포 가능 상태 | 실패 시 git restore | Fowler refactoring.com |
| 두 모자 | 리팩터링 ↔ 기능 추가 구분 | 한 번에 한쪽 | 다른 쪽 | diff 의 테스트 변경 | Fowler 2018 2장 |
| 기술 부채 | 정리하지 않은 비용 | 기능 추가 노력(이자) | — | 같은 규칙 고칠 곳 수 | Cunningham 1992 |
| 자동 도구 | 기계적 변환 | 호출부 전체 | 동작 | textDocument/rename · refactor.* | LSP 3.17 |
11참고 문헌
- 먼저 볼 문헌
- ★ Refactoring (Martin Fowler) — 명사 · 동사 두 정의와 작은 단계 원칙을 원문으로 볼 때
- ★ Refactoring: Improving the Design of Existing Code, Second Edition (Martin Fowler · Kent Beck) — 두 모자 · 코드 냄새 · 테스트 안전망 · 성능과의 관계를 볼 때
- ★ Catalog of Refactorings (Martin Fowler) — 기법 이름 · 옛 이름(Extract Method 등)을 찾을 때
- ★ The WyCash Portfolio Management System (Ward Cunningham · OOPSLA '92 Experience Report) — 기술 부채 은유가 처음 나온 원문을 볼 때
- 본문 근거
- Language Server Protocol Specification 3.17 — Microsoft · 2022-05 ·
microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/· 확인 2026-11-04 - Refactoring Object-Oriented Frameworks (William F. Opdyke · PhD thesis · University of Illinois at Urbana-Champaign) — University of Illinois · 1992-01 ·
hdl.handle.net/2142/72072· 확인 2026-11-04 - Reverse engineering and design recovery: a taxonomy (E. J. Chikofsky · J. H. Cross · IEEE Software 7(1)) — IEEE · 1990-01 ·
doi.org/10.1109/52.43044· 확인 2026-11-04 - Technical Debt (Martin Fowler bliki) — Martin Fowler · 2019-05 ·
martinfowler.com/bliki/TechnicalDebt.html· 확인 2026-11-04 - Workflows of Refactoring (Martin Fowler) — Martin Fowler · 2014-01 ·
martinfowler.com/articles/workflowsOfRefactoring/· 확인 2026-11-04 - Working Effectively with Legacy Code (Michael C. Feathers) — Prentice Hall · 2004-09 ·
www.informit.com/store/working-effectively-with-legacy-code-9780131177055· 확인 2026-11-04 - coverage.py — coverage report command — coverage.py · 2026-11 ·
coverage.readthedocs.io/en/latest/commands/cmd_report.html· 확인 2026-11-04 - git-restore Documentation — Git · 2026-11 ·
git-scm.com/docs/git-restore· 확인 2026-11-04 - git-grep Documentation — Git · 2026-11 ·
git-scm.com/docs/git-grep· 확인 2026-11-04