
아이템을 추가하는 코드를 정리했는데 가득 찬 인벤토리에서 아이템이 사라진다. 이름을 바꾸고 함수를 나눴을 뿐이라고 생각했지만, 실제로는 기존 행동까지 달라진 것이다. 게임 코드를 정리할 때 먼저 확인할 것은 구조가 깔끔해졌는지보다 어떤 행동을 유지해야 하는가다.
소프트웨어 설계와 리팩토링을 다루는 마틴 파울러는 리팩토링을 관찰 가능한 행동을 유지하면서 내부 구조를 바꾸는 작업으로 정의한다. 전면 재작성이나 기능 추가 전체를 같은 말로 묶으면, 무엇을 검증할지 흐려진다.
현재 동작을 확인할 수 있게 만든다
다음은 최대 수용량이 있는 인벤토리를 가정한 예시다. 슬롯이 남으면 아이템을 추가하고 성공을 반환한다. 가득 차면 기존 목록을 유지하고 실패를 반환한다고 정하자. 실제 프로젝트의 경험담이 아니라 변경 전후를 비교하기 위한 작은 규칙이다.
| 입력 조건 | 유지할 결과 |
|---|---|
| 빈 인벤토리에 아이템 추가 | 아이템이 들어가고 성공 반환 |
| 마지막 빈 슬롯에 추가 | 수용량까지 채워지고 성공 반환 |
| 가득 찬 상태에서 추가 | 기존 목록을 바꾸지 않고 실패 반환 |
실제 게임에서 가득 찬 가방의 아이템을 바닥에 떨어뜨리는 규칙을 쓰고 있다면 그 행동을 기준으로 삼아야 한다. 테스트를 만들면서 의도한 새 규칙으로 몰래 바꾸지 않는다. 확인한 현재 행동과 바꾸려는 요구사항을 먼저 구분한다.
한 번에 바꿀 책임을 정한다
버튼 입력, 용량 검사, 목록 변경, 효과음 재생이 한 함수에 들어 있다고 하자. 첫 변경에서는 용량 검사와 목록 갱신만 작은 단위로 분리해 볼 수 있다. 화면과 소리는 기존 함수를 통해 계속 연결한다.
변경 전: 버튼 입력 → 용량 검사 → 목록 갱신 → 화면·소리 갱신
변경 후: 버튼 입력 → 추가 규칙 호출 → 반환 결과로 화면·소리 갱신
분리 후에는 표의 조건으로 추가 규칙을 확인하고, 실제 화면에서도 성공·실패 표시가 같은지 검사한다. 내부 테스트가 통과해도 버튼 연결이나 연출이 잘못될 수 있으므로 두 수준의 확인이 모두 필요하다.
Google의 코드 리뷰 지침도 변경을 한 가지 의미에 집중시키는 작은 단위를 권한다. 여기서 작다는 것은 줄 수만 적다는 뜻이 아니다. 검토자가 변경 목적과 영향을 함께 이해할 수 있는 범위인지가 중요하다.
코드가 줄었다고 의존성이 줄어든 것은 아니다
비슷해 보이는 아이템·퀘스트·스킬 관리자를 하나의 공통 관리자로 합치면 중복 줄 수는 줄어들 수 있다. 하지만 변경 이유가 다른 기능들을 억지로 묶으면 공통 관리자를 고칠 때마다 관계없는 기능도 확인해야 한다.
다음과 같이 질문해 보자.
- 두 코드가 같은 규칙 때문에 함께 바뀌는가, 지금 모양만 비슷한가?
- 이 단위를 화면이나 네트워크 없이 실행할 수 있는가?
- 분리한 규칙의 입력과 결과를 설명할 수 있는가?
- 바꾸지 않은 기능에서 확인해야 할 범위가 오히려 늘지는 않았는가?
새 추상화가 도움 되는지는 상속 구조나 파일 수만으로 판단하기 어렵다. 인벤토리 예제라면 게임 전체를 실행하지 않고 추가 규칙을 확인할 수 있게 됐는지가 하나의 구체적인 기준이 된다.
기능 수정과 구조 변경을 분리한다
가득 찼을 때 실패하는 규칙을 아이템을 합치는 규칙으로 바꾸는 일은 기능 변경이다. 이를 리팩토링과 같은 변경에 넣으면 문제가 생겼을 때 원인을 구별하기 어렵다.
먼저 현재 행동을 유지하는 구조 변경을 확인한다. 그다음 새 규칙의 기대 결과를 적고 구현한다. 검증 가능한 작은 작업으로 나누기에서처럼 작업마다 결과와 확인 방법을 붙이면 검토와 되돌리기가 쉬워진다.
출시가 가까울 때도 날짜만으로 모든 정리를 금지하거나 허용하기보다, 수정 목적과 영향 범위, 테스트와 복구 수단을 함께 본다. 불확실한 대규모 통합을 서두르는 대신 필요한 변경을 좁혀야 한다.
리팩토링 완료를 확인하는 순서
- 유지할 행동을 입력·결과로 적는다.
- 현재 동작을 재현하는 테스트나 관찰 절차를 준비한다.
- 경계 하나를 바꾸고 결과를 비교한다.
- 화면·저장·네트워크 등 연결된 경로도 확인한다.
- 새 기능이나 버그 수정이 필요하면 별도 변경으로 진행한다.
자동 테스트가 아직 부족하다면 그 사실과 수동 확인 범위를 기록하고 변경을 더 작게 잡는다. 프로그램을 이해하려고 손댔다가 실행조차 못 하는 상태가 길어지지 않도록, 계속 비교할 수 있는 작동 상태를 확보하는 것이 출발점이다.
참고 자료
- Martin Fowler, Definition Of Refactoring: 관찰 가능한 행동 보존이라는 정의 확인.
- Google Engineering Practices, Small CLs: 의미가 집중된 변경과 검토 범위 확인.
- Google Engineering Practices, What to look for in a code review: 설계·동작·테스트를 함께 검토하는 기준.
인벤토리 표와 분리 흐름은 설명을 위해 구성한 예시다.