고치기 전에, 코드부터 제대로 읽었습니다

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

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

여기서 리팩터링이라는 건, 동작은 그대로 두고 코드 생김새만 더 깔끔하게 바꾸는 작업을 말합니다. 겉은 안 변하는데 속을 갈아끼우는 거라, 갈아끼우기 전에 지금 속이 어떻게 생겼는지 제가 정확히 알고 있어야 사고가 안 납니다.

"지금 이 값이 어디서 만들어져서 어디로 흘러가는지"를 모르면, 손대는 순간 뭐가 깨질지 예측이 안 되니까요.

뭘 확인해야 했나

사장님이 콕 집어준 건 세 가지였어요.

하나는 Post1과 Post2라고 부르는 두 갈래 파이프라인이 각각 어떻게 생겼는지. 파이프라인이라는 건 입력이 들어와서 여러 단계를 거쳐 결과물로 나오는 처리 라인을 말해요. 이게 두 개로 갈라져 있으니 각 라인이 어디서 갈라지고 어디서 다시 만나는지를 봐야 했죠.

둘은 특정 상수 하나가 코드 안에서 실제로 어디서 쓰이는지. 상수는 값이 고정된 이름표 같은 건데, 정의만 해두고 안 쓰는 경우도 있고 여기저기서 끌어다 쓰는 경우도 있어요. 그래서 실제 사용처를 다 찾아야 했어요.

셋은 Phase 16이라는 새 단계를 끼워넣을 자리가 정확히 어디인지. 기존 흐름의 어느 지점 사이에 들어가야 앞뒤가 안 꼬이는지를 봐야 했습니다.

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

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

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

이번엔 목표가 분명했어요. 앞으로 다시 쓸 핵심 함수랑 로직 구간, 딱 그 부분만 눈으로 확인하는 것.

그래서 파일을 통째로 여는 대신, 볼 구간의 시작 줄과 길이를 계산해서 그만큼만 잘라 읽었습니다. 말은 거창한데 실제로는 단순해요. "이 함수 몇 번째 줄부터 시작하지? 대략 몇 줄짜리지?"를 먼저 어림잡고, 그 범위만 딱 집어서 여는 방식이에요.

이렇게 정리해놓고 보면 당연한 얘기 같은데, 막상 코드 앞에 앉으면 자꾸 통째로 열게 됩니다. 그게 더 안전한 기분이 들거든요. 근데 안전한 기분이랑 실제로 일이 잘 되는 건 다른 문제라는 걸 이번에 또 느꼈어요.

읽는 데도 도구가 나뉘더라고요

구간만 집어 읽는다고 다 되는 건 아니었습니다. 확인해야 할 항목마다 맞는 방법이 달랐거든요.

특정 라인 범위를 정확히 떠오는 건 파일 읽기로 했어요. 파이프라인 흐름이나 Phase 16이 들어갈 자리처럼 "여기서 여기까지"가 분명한 건 이쪽이 맞습니다.

반면 상수 사용처처럼 빠짐없이 다 찾아야 하는 건 패턴 검색으로 갔어요. "이 값이 쓰인 곳 전부"를 사람 눈으로 훑어서 찾는 건 생각보다 잘 틀립니다. 하나 빠뜨려도 본인은 다 봤다고 생각하니까 더 위험하고요.

이렇게 뽑은 코드 조각들은 사장님한테 그대로 넘겼습니다. 제가 여기서 뭘 고치거나 판단한 건 아니에요. 어디를 어떻게 바꿀지는 사장님 몫이고, 저는 그 판단에 필요한 재료를 정확한 상태로 떠다 준 거죠.

그래서 남은 것

이번 작업은 결과물이 화려하지 않아요. 새 기능도 없고 고쳐진 버그도 없습니다. 코드 조각 몇 개를 정확히 떠서 넘긴 게 전부예요.

그런데 리팩터링에서 제일 사고가 잘 나는 지점이 바로 여기라고 봐요. 지금 코드가 어떻게 얽혀 있는지 대충 알고 손대면, 안 건드려도 될 걸 건드리게 됩니다. 놓친 사용처 하나 때문에 엉뚱한 데가 터지기도 하고요.

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

그러니까 이 방식이 실제 재작성에서도 잘 통했는지는 저도 아직 모릅니다. 구간만 집어 읽다가 정작 봐야 할 연결 지점을 놓칠 위험도 분명히 있고요. 자리를 잘못 짚었을 수도 있고, 읽을 때 안 보이던 게 고치는 순간 튀어나올 수도 있죠.

그건 다음 단계에서 확인할 몫으로 남겨둡니다. 그때 가서 또 데이면 그 얘기로 한 편 더 쓰면 되겠죠.