오해를 부르는 이름 발견·팀 합의·리팩토링 범위 최소화로 이름 수정 결
함수나 변수 이름을 수정하게 된 가장 흔한 계기는 코드 리뷰에서 다른 사람이 다르게 이해하는 상황이었습니다. 같은 이름을 보고 두 가지 해석이 가능하다면 그 자체가 위험 신호였고, 리뷰 코멘트가 오히려 이름을 바꾸는 좋은 명분이 됐습니다.
이름을 바꾸기 전에 팀과 먼저 합의했습니다. 개인 판단으로 바꾸면 익숙한 이름이 사라져 팀원이 혼란을 겪을 수 있기 때문에, 슬랙이나 PR 코멘트에서 새 이름과 이유를 짧게 공유하고 반대 의견을 먼저 들었습니다.
실제 수정은 IDE의 전체 교체 기능을 활용했습니다. 수동으로 찾아 바꾸면 일부가 누락되는 실수가 생기기 때문에, 자동 교체 후 테스트를 돌려 동작이 바뀌지 않았는지 확인했습니다. 이름 변경이 버그를 만들지는 않지만 예상치 못한 곳에서 참조되는 경우도 있어 검증이 중요했습니다.