들어가며

Next.js 15 버전에서는 pnpm을 기본 패키지 매니저로 권장하고 있다. 이러한 변화의 배경과 각 패키지 매니저의 특징을 살펴보면서, 프로젝트에 가장 적합한 선택이 무엇인지 알아보자.

• 가장 오래되고 널리 사용됨

  패키지 매니저는 프로젝트의 의존성을 관리하는 도구이다. Node.js 생태계에서는 주로 npm, yarn, pnpm이 사용되고 있으며, 각각의 도구는 고유한 특징과 장단점을 가지고 있다.

  1. npm (Node Package Manager)

  • 특징
    • Node.js의 기본 패키지 매니저
    • v5 이상부터 package-lock.json을 도입해 종속성을 고정하여 일관성 있는 설치 보장
  • 장점
    • 별도 설치 불필요 (Node.js에 포함)
    • 넓은 생태계와 커뮤니티
    • 안정적인 성능
  • 단점
    • 속도는 개선됐지만 여전히 느릴 수 있음
    • 패키지를 프로젝트별로 node_modules 디렉터리에 중복 설치하므로 이로 인한 디스크 공간 낭비
    • 의존성 지옥 발생 가능

  2. yarn (Yet Another Resource Negotiator)

  • 특징
    • Facebook에서 npm의 문제점을 해결하기 위해 개발한 패키지 관리자
    • 병렬 설치를 통한 성능 향상
    • yarn.lock을 통한 파일의 종속성 관리
  • 장점
    • npm보다 빠른 설치 속도
    • 더 나은 캐시 메커니즘
    • 보안성 강화 (체크섬 확인)
  • 단점
    • 별도 설치 필요
    • npm에 비해 더 많은 디스크 공간 사용
    • 일부 호환성 이슈 발생 가능

  3. pnpm (Performant npm)

  • 특징
    • 동일한 패키지는 하드 링크를 사용하여 전역적으로 한 번만 저장
    • node_modules가 실제 패키지를 복사하지 않고 심볼릭 링크를 사용
    • 단일 저장소에서 모든 프로젝트의 패키지 공유
    • pnpm-lock.yaml을 통해 종속성을 고정
    • 엄격한 의존성 관리
      • 프로젝트에 선언된 패키지(dependencies/devDependencies)만 접근 가능
      • 의도치 않은 패키지 종속성 문제 방지
  • 장점

    • 최소한의 디스크 공간 사용

      # 디스크 사용량 비교 (React 프로젝트 기준)
      npm: ~200MB
      yarn: ~200MB
      pnpm: ~50MB
      
      

    • 가장 빠른 설치 속도

      # 설치 시간 비교 (1000개 의존성 기준)
      npm: 1분 30초
      yarn: 1분 10초
      pnpm: 30초
      
      

    • 정확한 의존성 트리 구성

  • 단점
    • 상대적으로 새로운 도구
    • 일부 레거시 프로젝트와 호환성 이슈
    • 학습 곡선 존재

패키지 매니저란?

• 하드 링크 및 심볼릭 링크란?

Next.js 15에서 pnpm을 권장하는 이유

1. 성능 최적화
   • 빠른 설치 속도
   • 효율적인 디스크 공간 활용
   • 캐시 효율성
2. 의존성 관리
   • 엄격한 패키지 관리
   • 유령 의존성 방지
   • 안정적인 버전 관리
3. 모노레포 지원
   • 작업공간(workspace) 기능 내장
   • 효율적인 멀티 프로젝트 관리
   • 일관된 의존성 관리

패키지 매니저 사용 예시

• npm 사용

# 프로젝트 생성
npm init
# 패키지 설치
npm install react
# 개발 의존성 설치
npm install --save-dev typescript

• yarn 사용

# 프로젝트 생성
yarn init
# 패키지 설치
yarn add react
# 개발 의존성 설치
yarn add --dev typescript

• pnpm 사용

# 프로젝트 생성
pnpm init
# 패키지 설치
pnpm add react
# 개발 의존성 설치
pnpm add -D typescript