낯선 코드베이스에 적응하기

합류하면 수십만 줄의 코드가 눈앞에 있습니다. 이걸 다 이해해야 일을 시작할 수 있다고 생각하면 첫 주부터 무너집니다.

경력자도 낯선 코드베이스 전체를 머릿속에 담지 못합니다. 필요한 부분을 그때그때 파악하며 일합니다. 신입이 전체를 외우려는 것은 잘못된 목표입니다.

적응의 목표는 코드를 다 아는 것이 아니라, 필요할 때 필요한 곳을 찾아 들어가는 길을 익히는 것입니다.

코드를 눈으로만 읽으면 무엇이 실제로 일어나는지 모릅니다. 먼저 프로젝트를 실행해 동작을 보고, 그다음에 그 동작을 만드는 코드를 찾는 편이 훨씬 빠릅니다.

터미널·서버 코스에서 다룬 로그 읽기와 요청 추적이 여기서 바로 쓰입니다. 한 요청이 어떤 로그를 남기는지 보면 코드의 흐름이 눈에 들어옵니다.

폴더를 하나씩 열어 모든 파일을 훑는 것은 비효율적입니다. 대신 하나의 기능을 처음부터 끝까지 세로로 관통하는 편이 구조를 이해하는 데 빠릅니다.

• 1. 진입점을 찾습니다. 웹이면 컨트롤러, 화면이면 페이지 컴포넌트입니다.
• 2. 거기서 시작해 서비스, 데이터 접근까지 한 기능의 호출을 따라갑니다.
• 3. 그 과정에서 만나는 공통 모듈과 관례를 메모합니다.
• 4. 한 기능을 관통했으면 비슷한 다른 기능은 훨씬 빨리 읽힙니다.

낯선 코드를 보면 이상하거나 비효율적으로 보이는 부분이 눈에 띕니다. 신입이 흔히 하는 실수는 이걸 바로 고치려는 것입니다.

대부분의 이상한 코드에는 이유가 있습니다. 특수한 요구사항, 과거의 장애 대응, 외부 시스템의 제약일 수 있습니다. 맥락을 모르고 고치면 그 이유가 만든 방어를 걷어내게 됩니다.

적응이 잘 되고 있는지 판단하는 기준은 코드를 얼마나 아느냐가 아닙니다. 작은 기능 하나를 스스로 파악해서, 만들고, 검증하고, 올리기까지 해내는 것입니다.

이 한 바퀴를 돌면 개발 흐름 전체를 경험하게 됩니다. 그다음부터는 규모만 커질 뿐 같은 과정의 반복입니다.