IT › 소프트웨어 › 프로그래밍 › 코드 품질 관리

Refactoring리팩터링 · Refactoring

관찰 가능한 동작은 그대로 두고 코드의 내부 구조를 바꿔, 읽기 쉽고 고치는 비용이 적은 코드로 만드는 일이다. 작은 변환을 하나씩 적용하고 그때마다 테스트로 동작이 그대로인지 확인한다.

1요약

  1. 리팩터링은 Fowler 가 「관찰 가능한 동작을 바꾸지 않는 내부 구조 변경」으로 정의한 작업으로, 그 위에서 함수 추출 · 이름 바꾸기 같은 이름 붙은 변환이 한 번에 하나씩 적용되고 매번 테스트가 동작을 확인한다(Fowler refactoring.com).
  2. 구조를 정리하지 않은 코드는 기능 하나를 더할 때마다 추가 비용을 낸다 — Cunningham 은 1992년 이것을 기술 부채라 부르고, 덜 맞는 코드에 쓰는 시간을 그 부채의 이자라고 적었다(Cunningham 1992).
  3. 「리팩터링했더니 깨졌다」는 그 커밋에서 테스트 기대값이 바뀌었는가로 가른다 — 바뀌었으면 기능 변경이 섞인 것이고, 그대로인데 깨졌으면 테스트가 그 줄을 지나지 않은 안전망의 구멍이다.

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 통 하나만 옮김 작은 변환 한 번 3 옮길 때마다 맛보기 테스트 통과 판정 4 맛이 다르면 원래대로 되돌리기 정리를 미루면 새 메뉴 하나에 시간이 더 든다 기술 부채의 이자 기계가 정해진 방식으로 통을 옮겨 준다 자동 리팩터링 도구

그림 1 · 주방 정리는 손님이 받는 맛을 그대로 둔 채 통 하나씩 옮기고 맛보는 일이다 — 맛 기준표가 테스트, 통 옮기기가 변환 한 번이다.

흩어진 통같은 양념이 서랍 세 곳에
맛 기준표메뉴마다 지금 맛을 적어 둠
통 하나한 번에 한 통만 옮김
맛보기옮길 때마다 기준표와 대조
원위치맛이 다르면 바로 돌려놓음
새 메뉴정리된 주방에서 메뉴를 더함
비유 — 양념 통 모으기 실제 — 할인 계산 모으기 서랍 A 서랍 B 서랍 C 선반 한 칸 — 통 하나 맛보니 다른 양념 그대로 둠 계산 1 7줄 계산 2 7줄 계산 3 반올림 먼저 apply_discount() · 9줄 동작이 달라 남김 통을 찾을 곳 3 → 2 맛 기준표 12줄 모두 그대로 할인 규칙을 고칠 곳 3 → 2 테스트 12개 모두 통과 점선 상자 = 테스트(맛보기)가 다른 동작을 찾아 합치지 않은 것 · 줄 수 · 테스트 수 = 설명용 가정 값

그림 2 · 맛을 보니 셋째 서랍의 통은 다른 양념이었다 — 실제로도 테스트가 다른 동작을 찾아낸 계산은 합치지 않고 남긴다.

비유 속 역할실제 이름실제로 하는 일
손님이 받는 맛관찰 가능한 동작같은 입력에 같은 출력 · 부작용을 내며, 리팩터링 전후로 바뀌지 않는다
흩어진 양념 통코드 냄새중복 코드 · 긴 함수처럼 구조를 손볼 곳을 알리는 신호다
맛 기준표테스트 안전망지금 동작을 고정해, 변환 뒤 달라진 것을 바로 알린다
통 하나 옮기기리팩터링 기법 한 번함수 추출 · 이름 바꾸기처럼 이름 붙은 작은 변환을 하나 적용한다
맛보기테스트 실행변환마다 전체 테스트를 돌려 모두 통과해야 다음으로 간다
원래 서랍으로되돌리기실패하면 고쳐 맞추지 않고 직전 커밋으로 돌린 뒤 더 작게 다시 한다
통 찾는 시간기술 부채의 이자구조가 나빠 기능 추가마다 더 드는 노력이다
통 옮기는 기계자동 리팩터링 도구편집기 · 언어 서버가 호출부까지 한 번에 고쳐 준다

⚠ 비유가 맞지 않는 곳: 맛보기는 요리사가 떠올린 메뉴만 확인하지만, 테스트도 작성한 경우만 확인하므로 «테스트 통과 = 동작 보존»은 테스트가 덮은 범위에서만 성립한다. 또 주방 정리는 영업과 따로 하지만, 리팩터링은 기능 추가 사이사이에 몇 분 단위로 끼워 넣는 것이 보통이다(Fowler 2014).

4구조 — 리팩터링 한 바퀴의 구성 요소

리팩터링 한 번은 냄새 · 기법 · 변환 · 테스트 네 요소가 도는 고리이고, 고리를 한 바퀴 돌 때마다 관찰 가능한 동작은 그대로다. Fowler 의 동사 정의도 «리팩터링(명사)을 여러 번 적용해 구조를 바꾸는 것»이라 한 바퀴가 작업의 단위가 된다(Fowler refactoring.com).

리팩터링 한 바퀴 바퀴마다 관찰 가능한 동작은 그대로 선택 — 자동 도구가 변환을 대신 rename · refactor.extract · refactor.inline (LSP 3.17) 코드 냄새 바꿀 곳의 신호 기법 선택 카탈로그 이름 작은 변환 한 번에 하나 테스트 실행 같은 입력 · 같은 출력 실패 통과 되돌림 더 작게 다시 커밋 다음 냄새로 냄새 = 결함 신호 · 기법 = 규칙 · 변환 = 코드 · 테스트 = 검증 · 굵은 테두리 상자 = 선택(자동 도구)

그림 3 · 냄새가 기법을 고르고, 변환 한 번마다 테스트가 판정해 통과하면 커밋 · 실패하면 되돌린다 — 이 고리를 여러 번 도는 것이 리팩터링이다.

요소역할예 · 값근거
코드 냄새구조를 손볼 곳을 알리는 신호Duplicated Code · Long Function · Feature Envy · Shotgun SurgeryFowler 2018 3장
기법이름과 절차가 정해진 변환Extract Function(옛 Extract Method) · Rename Variable · Inline Function · Move FunctionFowler 카탈로그
변환 한 번동작을 지키는 가장 작은 코드 변경커밋 하나 · 몇 분 단위Fowler refactoring.com
테스트 안전망변환마다 동작 보존을 판정기존 동작을 고정하는 특성 테스트Feathers 2004
관찰 가능한 동작지켜야 할 경계공개 함수의 입력 · 출력 · 부작용Fowler refactoring.com
사전 조건변환이 안전한지 미리 확인새 이름이 같은 범위에 없을 것Opdyke 1992

🔑 리팩터링은 «동작을 지킨 채 구조만 바꾼다»가 아니라 «테스트가 덮은 동작을 지킨 채 바꾼다»이다 — 안전망이 없는 코드에서는 첫 작업이 변환이 아니라 테스트 작성이다.

5동작 — 할인 계산 중복을 함수 하나로 모으는 사례

Python 주문 모듈의 order_total() 함수는 52줄이고, 회원 등급별 할인 계산 7줄이 세 곳에 되풀이된다(설명용 가정 값). 할인 규칙이 바뀌면 세 곳을 모두 고쳐야 하는 Shotgun Surgery 냄새다.

  1. 안전망 — 지금 동작을 고정하는 특성 테스트 12개를 쓰고, coverage report -m 의 Missing 열에 order_total() 줄이 하나도 없음을 확인한다(coverage.py report).
  2. 이름 바꾸기 — 지역 변수 d 를 discount_rate 로 바꾼다(Rename Variable · 편집기의 언어 서버 textDocument/rename) · 테스트 12/12 통과 · 커밋 r1.
  3. 함수 추출 — 첫째 할인 계산 7줄을 apply_discount(amount, grade) 로 뽑는다(Extract Function) · 12/12 · 커밋 r2.
  4. 한꺼번에 시도 — 둘째 · 셋째 계산을 한 번에 호출로 바꾸자 11/12 로 하나가 실패한다 → 고쳐 맞추지 않고 git restore order.py 로 r2 상태로 되돌린다(git-restore).
  5. 더 작게 — 둘째 계산만 바꾼다 · 12/12 · 커밋 r3.
  6. 다른 동작 발견 — 셋째 계산만 바꾸자 다시 하나가 실패한다(11/12) — 셋째 곳은 할인 전에 반올림을 하는 다른 동작이었다 → 되돌리고, 그 차이를 테스트 이름에 남긴다.
  7. 결과 — order_total() 31줄 + apply_discount() 9줄 · 할인 규칙을 고칠 곳 3 → 2 · 테스트 12개는 처음과 같다. 새 등급 할인 요구는 이 뒤에 «기능 추가»로 따로 한다.
단계 테스트 12개 결과 처리 1 안전망 작성 12개 작성 2 이름 바꾸기 d → discount_rate 커밋 r1 3 함수 추출 apply_discount 커밋 r2 4 둘째 · 셋째 한꺼번에 되돌림 5 둘째만 커밋 r3 6 셋째만 되돌리고 남김 결과 — order_total() 52줄 → 31줄 + apply_discount() 9줄 · 할인 규칙을 고칠 곳 3 → 2 · 테스트 12개 그대로 통과한 테스트 실패한 테스트 상자 = 테스트 하나 · 줄 수 · 테스트 수 = 설명용 가정 값

그림 4 · 변환마다 테스트 12개를 돌려 모두 통과한 셋만 커밋했고, 실패한 두 번은 되돌렸다 — 둘째 실패는 숨은 다른 동작을 찾아냈다.

리팩터링 중에는 테스트를 더하지도 고치지도 않고, 기능을 더할 때만 테스트가 는다. Kent Beck 은 이것을 «두 모자»라 불렀다 — 한 번에 한 모자만 쓰고, 모자를 바꿀 때를 스스로 안다(Fowler 2018 2장).

리팩터링 기능 추가 리팩터링 기능 추가 리팩터링 쓰고 있는 모자 테스트 수 12 13 14 구간 1 구간 2 구간 3 구간 4 구간 5 새 테스트 실패 새 테스트 실패 12개 그대로 13개 그대로 14개 그대로 r1 ~ r3 테스트 수 새 테스트가 아직 통과하지 못한 동안 · 리팩터링 구간에는 테스트를 더하지도 고치지도 않음

그림 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시험 대비

출제 정보 정보관리(139회, 129회, 127회, 119회, 95회) · 컴퓨터시스템응용(129회)문제 원문 — 큐넷 자료실 「기출문제(기술사)」 www.q-net.or.kr

시험에서는 정의와 원칙(동작 보존 · 작은 단계 · 테스트)을 묻는 정의 · 특징형, 재공학 · 재작성 · 성능 최적화와 견주는 비교형이 나올 수 있다. 기술 부채를 함께 묻는 경우 부채가 생기는 원인 · 갚는 방법으로 리팩터링을 놓는다.

답안 목차
  1. 개요 — 정의(Fowler · 관찰 가능한 동작 불변) · Opdyke 1992 · 목적(이해 · 수정 비용)
  2. 구성 요소 — 그림 3 리팩터링 한 바퀴(냄새 → 기법 → 변환 → 테스트 → 커밋 · 되돌림) + 요소 표
  3. 절차 사례 — 그림 4 단계별 테스트 결과(이름 바꾸기 · 함수 추출 · 실패 뒤 되돌림)
  4. 원칙 — 그림 5 두 모자(리팩터링 중 테스트 수 그대로) · 작은 단계 · 테스트 안전망
  5. 비교 — 비교표(리팩터링 · 성능 최적화 · 재작성 · 기능 추가 — 동작 · 단위 · 테스트)
  6. 기술 부채와 도구 — 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 -mFeathers 2004
작은 단계실패 범위를 좁힘커밋 하나배포 가능 상태실패 시 git restoreFowler refactoring.com
두 모자리팩터링 ↔ 기능 추가 구분한 번에 한쪽다른 쪽diff 의 테스트 변경Fowler 2018 2장
기술 부채정리하지 않은 비용기능 추가 노력(이자)—같은 규칙 고칠 곳 수Cunningham 1992
자동 도구기계적 변환호출부 전체동작textDocument/rename · refactor.*LSP 3.17

11참고 문헌

  1. 먼저 볼 문헌
  2. ★ Refactoring (Martin Fowler) — 명사 · 동사 두 정의와 작은 단계 원칙을 원문으로 볼 때
    Martin Fowler · 2026-11 · refactoring.com/ · 확인 2026-11-04
  3. ★ Refactoring: Improving the Design of Existing Code, Second Edition (Martin Fowler · Kent Beck) — 두 모자 · 코드 냄새 · 테스트 안전망 · 성능과의 관계를 볼 때
    Addison-Wesley · 2018-11 · www.informit.com/store/refactoring-improving-the-design-of-existing-code-9780134757599 · 확인 2026-11-04
  4. ★ Catalog of Refactorings (Martin Fowler) — 기법 이름 · 옛 이름(Extract Method 등)을 찾을 때
    Martin Fowler · 2026-11 · refactoring.com/catalog/ · 확인 2026-11-04
  5. ★ The WyCash Portfolio Management System (Ward Cunningham · OOPSLA '92 Experience Report) — 기술 부채 은유가 처음 나온 원문을 볼 때
    Ward Cunningham · 1992-03 · c2.com/doc/oopsla92.html · 확인 2026-11-04
  6. 본문 근거
  7. Language Server Protocol Specification 3.17 — Microsoft · 2022-05 · microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/ · 확인 2026-11-04
  8. 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
  9. 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
  10. Technical Debt (Martin Fowler bliki) — Martin Fowler · 2019-05 · martinfowler.com/bliki/TechnicalDebt.html · 확인 2026-11-04
  11. Workflows of Refactoring (Martin Fowler) — Martin Fowler · 2014-01 · martinfowler.com/articles/workflowsOfRefactoring/ · 확인 2026-11-04
  12. 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
  13. coverage.py — coverage report command — coverage.py · 2026-11 · coverage.readthedocs.io/en/latest/commands/cmd_report.html · 확인 2026-11-04
  14. git-restore Documentation — Git · 2026-11 · git-scm.com/docs/git-restore · 확인 2026-11-04
  15. git-grep Documentation — Git · 2026-11 · git-scm.com/docs/git-grep · 확인 2026-11-04