Next.js 용량 주의!! - 1GB 중 980MB는 쓸모없는 파일? 중요 프로젝트 실제 크기 20MB !

1. Next.js 프로젝트의 충격적인 용량 비밀

여러분이 열심히 코딩한 Next.js 프로젝트의 실제 크기는 고작 20MB 정도입니다. 그런데 폴더 전체 용량을 확인하면 1GB가 넘는 경우가 대부분이죠. 이게 도대체 무슨 일일까요?

실제 프로젝트 코드 (20MB)
- app 폴더: 페이지와 라우팅을 담당하는 핵심 코드
- components 폴더: 재사용 가능한 React 컴포넌트들
- lib, hooks 폴더: 유틸리티 함수와 커스텀 훅
- public 폴더: 이미지, 폰트 등 정적 파일
- 각종 설정 파일: tsconfig.json, tailwind.config.ts 등
캐시와 모듈 파일 (980MB)
- node_modules 폴더: 900MB 이상의 npm 패키지들
- .next 폴더: 50-100MB의 빌드 캐시
놀라운 사실 실제로 여러분이 작성한 코드는 전체 용량의 2%에 불과합니다. 나머지 98%는 자동으로 생성되거나 다운로드된 파일들이죠. 이것이 바로 현대 웹 개발의 특징입니다.

프로젝트 용량이 부담스러우신가요? 그렇다면 어떤 폴더를 삭제해도 되는지 정확히 알아보겠습니다.

즉시 삭제 가능한 폴더와 파일
- .next 폴더: Next.js 빌드 캐시로, 삭제해도 자동으로 재생성됩니다
- node_modules 폴더: npm install 명령으로 언제든 복구 가능합니다
- .env.example: 실제 .env 파일이 있다면 불필요한 예제 파일입니다
- 프로젝트와 관련 없는 README 파일들
조건부로 삭제 가능한 것들
- .env.local: 로컬 환경변수가 저장된 파일로, 필요한 설정이 있는지 확인 후 삭제
- 사용하지 않는 도구 폴더들: claude-code-requirements-builder 같은 폴더
절대 삭제하면 안 되는 핵심 폴더
- app, components, lib, hooks: 실제 소스 코드가 담긴 폴더
- public: 정적 파일들이 저장된 폴더
- 모든 설정 파일: tsconfig.json, next.config.mjs, tailwind.config.ts
- package.json과 package-lock.json: 프로젝트 의존성 정보

많은 개발자들이 가장 궁금해하는 부분입니다. ".next 폴더를 삭제해도 정말 괜찮을까요?" 답은 "전혀 문제없습니다!"입니다.

.next 폴더의 정체 이 폴더는 Next.js가 빌드 과정에서 생성하는 임시 캐시 폴더입니다. 컴파일된 파일, 최적화된 이미지, 빌드 정보 등이 저장되어 있죠.
삭제해도 안전한 이유
- npm run dev 실행 시 자동으로 재생성됩니다
- 프로젝트 소스 코드에는 전혀 영향을 주지 않습니다
- Git에서도 기본적으로 제외되는 폴더입니다 (.gitignore에 포함)
삭제하면 좋은 경우
- 빌드 관련 오류가 발생할 때
- 캐시 문제로 변경사항이 반영되지 않을 때
- 프로젝트 용량을 일시적으로 줄이고 싶을 때
- 깨끗한 상태에서 다시 빌드하고 싶을 때

node_modules는 프로젝트 용량의 대부분을 차지하는 주범입니다. 하지만 이 폴더도 언제든 삭제하고 복구할 수 있습니다.

node_modules 삭제가 가능한 이유 package.json 파일에 모든 의존성 정보가 저장되어 있기 때문입니다. 이 파일만 있으면 npm install 명령 하나로 모든 패키지를 다시 설치할 수 있죠.
삭제 후 복구 방법
```
npm install  # 또는 yarn install
```
이 명령어 하나면 package.json에 명시된 모든 패키지가 자동으로 설치됩니다.
node_modules를 삭제하면 좋은 상황
- 프로젝트를 압축하거나 이동할 때
- 패키지 관련 오류를 해결하고 싶을 때
- 의존성을 깨끗하게 재설치하고 싶을 때
- 디스크 공간을 일시적으로 확보하고 싶을 때

이제 Next.js 프로젝트의 용량을 효율적으로 관리하는 실전 팁을 알려드리겠습니다.

프로젝트 백업 시
- .next와 node_modules는 제외하고 백업하세요
- 20MB의 실제 코드만 백업해도 충분합니다
- 복원 시 npm install로 쉽게 환경을 재구성할 수 있습니다
Git 저장소 관리
- .gitignore 파일이 자동으로 불필요한 폴더를 제외합니다
- 실제로 GitHub에는 20MB의 코드만 올라갑니다
- 다른 개발자도 clone 후 npm install로 환경 구성이 가능합니다

용량 부족 시 임시 해결책

rm -rf .next node_modules  # 약 1GB 확보
# 필요할 때 다시 설치
npm install && npm run dev

프로젝트 이동 시
- node_modules와 .next를 제외하고 압축하면 용량이 98% 감소합니다
- 새 환경에서 npm install만 실행하면 완벽하게 복구됩니다