기존의 호이스팅 방식과 pnpm의 의존성 트리 유지 방식
pnpm은 Performant NPM, 즉 높은 성능을 내는 npm이라는 의미이다.
npm은 공식적으로 ‘줄여쓴 약자가 아니다(npm is not an acronym)’라고 하지만 누구에게나 Node Package Manager라고 하면 쉽게 설명이 된다…
회사 프로젝트에서도 npm → yarn → yarn berry를 거쳐 현재는 pnpm을 기본으로 사용하고 있으며, 특성상 낮은 노드 버전 유지가 필요한 곳만 npm을 사용하고 있다.
그렇다면 다른 패키지 매니저와 비교해 pnpm의 특징을 먼저 살펴보자.
| 특징 | pnpm | npm / yarn |
|---|---|---|
| 속도 | 빠름(병렬 처리) | 다소 느림 |
| 효율성 | 좋음(글로벌 캐싱, 링크 사용) | 낮음(중복 저장 가능성) |
| 호환성 | npm 호환 | Node.js 기본 |
| 의존성 관리 | 엄격함(충돌 방지 장점) | 느슨함 |
| 모노레포 지원 | 워크스페이스 지원 | yarn 일부 지원 |
pnpm의 의존성 관리 방식은 기존의 호이스팅(hoisting) 방식을 사용하는 패키지 매니저와 차별화된다. 호이스팅 방식과 pnpm 고유의 의존성 트리 유지 방식을 비교해보자.
호이스팅 방식
전통적인 패키지 매니저(npm, yarn)에서 사용되는 방식으로, 의존성을 프로젝트 루트의 node_modules 디렉토리로 끌어올리는 것을 의미한다.
모든 의존성을 루트 디렉토리에 설치하여, 하위 패키지에서 해당 의존성을 마치 루트에 설치된 것처럼 접근이 가능하도록 한다.
호이스팅 방식의 장점
1. 간단한 접근 : 모든 패키지가 같은 디렉토리에 설치되므로, 의존성을 찾는 데 간단한 구조를 갖는다.
2. 중복 제거 : 중복된 의존성을 상위로 끌어올려 디스크 사용량이 줄어든다.
호이스팅 방식의 단점
1. 의존성 충돌 : 서로 다른 패키지가 동일한 이름의 의존성을 서로 다른 버전으로 요구할 때, 하나의 버전만 설치되므로 충돌 발생 가능성 존재한다.
2. 의존성 숨김 문제 : 하위 패키지가 암묵적으로 루트에 있는 의존성에 접근하게 되어, 의존성을 명시하지 않고 사용할 위험이 있다.
따라서 패키지가 다른 프로젝트에서 독립적으로 작동하지 않을 가능성이 높아진다.
pnpm 고유의 의존성 트리 유지 방식
pnpm은 의존성을 독립적으로 관리하며, 각 패키지의 의존성 트리를 유지한다. 또한 “flat” 구조 대신 하드 링크와 심볼릭 링크를 사용하여, 의존성이 설치된 위치를 참조만 한다.
작동 방식
.pnpm 디렉토리
모든 의존성은 루트의 node_modules 디렉토리 내부 .pnpm 디렉토리에 설치된다. 중복된 의존성은 단일 디렉토리에 저장하고, 필요한 위치에서 해당 파일에 심볼릭 링크를 생성한다.
독립적 의존성 트리
각 패키지는 자신만의 node_modules를 가지고, 필요한 의존성을 .pnpm에서 참조한다.
예를 들면 다음과 같은 구조다.
project/
├── node_modules/
│ ├── package-a/
│ │ └── node_modules/
│ │ └── dependency-a@1.0.0 -> .pnpm/dependency-a@1.0.0
│ ├── package-b/
│ │ └── node_modules/
│ │ └── dependency-a@2.0.0 -> .pnpm/dependency-a@2.0.0
따라서 package-a와 package-b는 서로 다른 버전의 dependency-a를 독립적으로 사용할 수 있다.
pnpm 방식의 장점
1. 의존성 충돌 방지 : 각 패키지가 독립적으로 의존성을 관리하므로, 서로 다른 버전의 의존성을 문제없이 사용할 수 있다.
2. 빠른 설치 : 동일한 의존성을 중복 다운로드하지 않고, 심볼릭 링크를 통해 참조하므로 속도가 빠르다.
3. 디스크 공간 절약 : .pnpm 디렉토리에 모든 의존성을 공유 저장하므로 중복 설치를 방지한다.
4. 명시적 의존성 사용 : 패키지는 반드시 자신이 명시적으로 선언한 의존성만 접근이 가능하며, 루트에 설치된 의존성에 암묵적으로 의존하지 않는다.
pnpm 방식의 단점
1. 복잡한 디렉토리 구조 : 심볼릭 링크를 사용하여 디렉토리 구조가 일반적인 방식보다 복잡해 보일 수 있다.
2. 호환성 문제 : 일부 오래된 라이브러리나 스크립트가 node_modules 트리 구조를 가정한 방식으로 동작할 경우 문제가 생길 수 있다.
pnpm의 의존성 관리 방식은 의존성 충돌 방지, 디스크 공간 절약, 명시적 의존성 관리에 강점을 가지고 있다. 특히 대규모 프로젝트에서 각 패키지의 독립적 의존성을 관리에 매우 유용하다.