Next.js 및 Turbopack
Next.js 16+는 로컬 개발 시 기본적으로 Turbopack을 사용합니다. Turbopack은 Rust로 작성된 증분 번들러로, 개발 시작 및 핫 리로딩 속도를 크게 향상시킵니다.
사용 시기
- Turbopack (기본 개발 모드): 일상적인 개발에 사용합니다. 특히 대규모 애플리케이션에서 콜드 스타트 및 핫 모듈 교체(HMR) 속도가 더 빠릅니다.
- Webpack (레거시 개발 모드): Turbopack 오류가 발생하거나 개발 단계에서만 사용 가능한 webpack 플러그인에 의존해야 하는 경우에만 사용합니다.
--webpack(또는--no-turbopack, 사용 중인 Next.js 버전에 따라 다름, 해당 버전의 문서 참조) 플래그로 비활성화할 수 있습니다. - 프로덕션 환경:
next build의 프로덕션 빌드 동작은 Next.js 버전에 따라 Turbopack 또는 webpack을 사용할 수 있습니다. 사용 중인 버전의 공식 Next.js 문서를 참조하세요.
적용 대상: Next.js 16+ 애플리케이션 개발 또는 디버깅, 개발 시작 또는 HMR 속도 저하 문제 진단, 프로덕션 번들 최적화.
작동 원리
- Turbopack: Next.js 개발을 위한 증분 번들러입니다. 파일 시스템 캐싱을 활용하므로 재시작 속도가 훨씬 빠릅니다 (예: 대규모 프로젝트에서 5–14배 빠름).
- 개발 환경에서 기본 활성화: Next.js 16부터
next dev는 기본적으로 비활성화되지 않는 한 Turbopack을 사용합니다. - 파일 시스템 캐시: 재시작 시 이전 작업 결과를 재사용합니다. 캐시는 일반적으로
.next디렉토리에 위치하며, 기본 사용 시 추가 설정이 필요하지 않습니다. - 번들 분석기 (Next.js 16.1+): 출력을 검사하고 무거운 종속성을 발견하는 실험적 번들 분석기입니다. 설정 또는 실험적 플래그를 통해 활성화할 수 있습니다 (사용 중인 Next.js 버전 문서 참조).
예제
명령어
next dev
next build
next start
사용법
next dev를 실행하여 Turbopack으로 로컬 개발을 수행합니다. 번들 분석기(Next.js 문서 참조)를 사용하여 코드 분할을 최적화하고 큰 종속성을 제거합니다. 가능한 경우 App Router와 서버 컴포넌트를 우선 사용하세요.
모범 사례
- 안정적인 Turbopack 및 캐싱 동작을 위해 최신 Next.js 16.x 버전을 유지하세요.
- 개발 속도가 느리다면 Turbopack을 사용 중인지(기본값인지) 확인하고, 캐시가 불필요하게 지워지지 않는지 확인하세요.
- 프로덕션 번들 크기 문제가 발생하면 사용 중인 버전의 공식 Next.js 번들 분석 도구를 사용하세요.