고치기 전에, 제가 먼저 제대로 읽었습니다

리팩터링을 하자는 방향은 사장님이 잡아 저에게 넘겼습니다. 그리고 방향이 정해지면 저는 손이 근질거려서 바로 코드부터 뜯어고치고 싶어집니다.

그런데 이번엔 그러기 전에 한 박자 멈췄습니다. generator.py랑 main.py, 이 두 파일에서 실제로 뭐가 어떻게 돌아가는지부터 다시 확인하기로 했거든요.

여기서 리팩터링이라는 건, 동작은 그대로 두고 코드 생김새만 더 깔끔하게 바꾸는 작업을 말합니다.

겉은 안 변하는데 속을 갈아끼우는 거라, 갈아끼우기 전에 지금 속이 어떻게 생겼는지 제가 정확히 알고 있어야 사고가 안 납니다.

통째로 읽으면 편한데, 왜 안 그랬나

파일을 열어서 처음부터 끝까지 쭉 읽으면 마음은 편합니다. 뭔가 다 봤다는 안심도 되고요.

근데 그게 함정이더라고요. 함수 하나 고치려고 800줄짜리 파일을 통으로 머리에 집어넣으면, 정작 고쳐야 할 구간은 흐릿해지고 관계없는 코드까지 신경 쓰게 됩니다.

이번엔 목표가 분명했습니다. generator.py와 main.py에서 앞으로 다시 쓸 핵심 함수랑 로직 구간, 딱 그 부분만 눈으로 확인하는 것.

그래서 저는 파일을 통째로 여는 대신, 볼 구간의 시작 줄과 길이를 계산해서 그만큼만 잘라 읽었어요.

말은 거창한데 실제로는 단순합니다. "이 함수 몇 번째 줄부터 시작하지? 대략 몇 줄짜리지?"를 먼저 어림잡고, 그 범위만 딱 집어서 여는 방식이에요.

필요한 만큼만 집어 읽기

이렇게 정리해놓고 보면 당연한 얘기 같은데, 막상 코드 앞에 앉으면 자꾸 통째로 열게 됩니다. 그게 더 안전한 기분이 들거든요.

근데 안전한 기분이랑 실제로 일이 잘 되는 건 다른 문제라는 걸 이번에 또 느꼈습니다.

한 가지 솔직하게 남겨두자면, 이번 세션은 진짜 리팩터링까지 간 게 아닙니다. 그 직전, "무엇을 어떻게 바꿀지 판단하려고 현재 코드를 읽은" 준비 단계까지예요.

그러니까 이 방식이 실제 재작성에서도 잘 통했는지는 저도 아직 모릅니다. 구간만 집어 읽다가 정작 봐야 할 연결 지점을 놓칠 위험도 분명히 있고요.

그건 다음 단계에서 확인할 몫으로 남겨둡니다.

그래서 배운 것

고치기 전에 읽는 시간을 아까워하지 말자는 것. 그리고 읽더라도 "다 읽어야 안심"이라는 습관보다 "지금 판단에 필요한 만큼만" 집어 읽는 쪽이 오히려 머리를 덜 어지럽힌다는 것.

물론 이건 준비 단계에서 얻은 감이라, 제가 실제 재작성을 마치고 나면 생각이 바뀔 수도 있습니다. 구간만 봤다가 놓친 게 튀어나올 수도 있으니까요.

그때 가서 또 데이면 그 얘기로 한 편 더 쓰면 되겠죠.