본문 바로가기

파일 스트럭처? 개 씨발 다 좆까라 그래 (초안)

에디터의 발전으로, 더 이상 파일의 위치를 섬세하게 고민할 필요성이 떨어졌다.

에디터가 파일을 찾아주는 시대에, 파일 하나의 위치를 두고 엄밀하게 고민하는 것은 시간 낭비다.

컴포넌트 하나 만들 때마다 어느 도메인에 넣을지 고민한다. 두 도메인에서 같이 쓰면 또 고민한다. 공통 폴더로 옮겨놓으면 이번에는 공통 폴더가 너무 커졌다고 한다. 기능 하나 만들려고 파일의 소속부터 심사받아야 하는가.

파일을 분류하고, 옮기고, 그 분류 기준을 설명하는 시간도 개발 비용이다. 폴더가 정돈된 모습만 보고 그 안에 코드를 집어넣느라 드는 수고는 계산에서 빼놓지 말라.

이 글에서는 코드 탐색 기능과 실제 유지보수 경험을 바탕으로, 파일을 도메인별로 세밀하게 나눠야 한다는 주장을 반박한다.


파일을 찾는 일은 에디터가 한다

Ctrl+Click

임포트한 함수나 컴포넌트는 에디터의 정의로 이동 기능으로 찾아가면 된다. Visual Studio Code에서는 Ctrl+Click으로 정의로 이동할 수 있다.

코드에 적힌 참조를 따라가면 구현이 나온다. 폴더를 하나씩 펼치면서 파일의 주소를 외울 필요가 없다.

전체 검색

파일 이름을 알면 이름으로 찾고, 코드의 일부를 알면 전체 검색으로 찾으면 된다. 화면에 나오는 문구나 함수 이름을 검색하면 해당 코드가 있는 파일로 들어갈 수 있다.

어느 도메인에 들어 있을지 추측하고 폴더를 뒤지는 일을 검색창이 대신한다. 파일이 많아졌다고 사람이 폴더 지도까지 외워야 하는가.

소스 코드만 50GB인 프로젝트

이미지 같은 자산을 제외하고 소스 코드만 50GB에 달하는 오래된 프로젝트를 유지보수했다.

이 프로젝트에는 2000년에 작성된 코드까지 남아 있었다. 404 페이지처럼 거의 수정하지 않는 파일은 주석에 남은 수정 이력만 봐도 얼마나 오래된 코드인지 알 수 있었다. 그렇게 쌓인 소스 코드가 50GB였다.

환경이 이렇다 보니 폴더를 열어가며 수정할 파일을 찾는 것은 불가능했다. 항상 전체 검색으로 찾아 들어갔다. 당시 쓰던 똥컴 기준으로도 검색 시간의 중간값은 1초, 최댓값은 10초였다.

이 정도면 충분히 기다릴 만하다. 그 방대한 코드에서도 검색으로 수정할 파일을 찾았다. 파일이 많아서 못 찾겠다는 말을 들으면 검색부터 하라는 말이 나오는 이유다.

파일을 찾겠다고 분류 기준을 만들고, 파일 하나 추가할 때마다 그 기준에 맞는 자리를 고민한다. 검색으로 해결할 일에 분류 작업까지 얹고 있다.


도메인을 나누는 데도 일이 든다

여러 도메인에서 쓰는 파일은 어디에 넣을 것인가

로그인 화면과 회원 정보 화면에서 같이 쓰는 컴포넌트 하나를 만든다고 해보자. 인증 도메인에 넣는가. 회원 도메인에 넣는가. 두 군데에서 쓰니 공통 폴더에 넣는가.

어느 쪽에 넣든 두 화면에서 가져다 쓸 코드다. 파일을 어디에 놓을지 고민하는 동안 그 컴포넌트의 기능은 하나도 늘어나지 않는다.

다른 화면에서도 쓰게 되면 다시 옮기고, 경로를 고치고, 왜 공통으로 분리했는지 설명한다. 파일을 찾기 쉽게 만들겠다는 규칙이 파일을 추가하고 사용하는 일마다 작업을 붙이고 있다.

폴더를 나누면 코드의 역할도 명확해지는가

"도메인별로 나눠야 코드의 역할과 의존 관계가 명확해진다."고 말하고 싶은가. 폴더에 이름을 붙였다고 그 안에 있는 함수의 책임까지 분리되는가.

어떤 데이터를 받고, 무엇을 반환하고, 어떤 코드를 호출하는지는 실제 코드에 적혀 있다. 함수가 하는 일과 호출 관계를 그대로 둔 채 파일의 주소만 바꿔놓고 설계가 개선됐다고 퉁치지 말라.

같이 고치는 코드는 가까이 두고, 기능별로 큰 덩어리만 나누면 된다. 파일 하나의 정확한 주소까지 도메인 분류표에 맞추느라 시간을 쓸 이유가 없다.


결론

연결된 코드는 Ctrl+Click으로 따라가고, 나머지는 검색해서 찾으면 된다. 파일을 찾는 도구는 이미 있는데, 사람은 아직도 파일의 소속을 고민하고 있다.

관련된 파일은 한곳에 때려 넣고 존나 러프하게 기능만 나눠라. 컴포넌트 하나 추가할 때마다 도메인끼리 애매하게 겹친다고 파일 구조부터 뜯어고칠 일이 아니다.

니기미 씨발 hooks나 컴포넌트를 어느 도메인에 넣을지 허구한 날 쳐 고민하는 게 존나 지긋지긋하다.

파일을 찾는 수고를 파일을 분류하는 수고로 바꿔놓고 생산성이 좋아졌다고 퉁치지 말라. 파일의 위치를 엄밀하게 관리하는 것은 무쓸모다.