자주 묻는 질문
패키지가 전역 스토어에 저장되는데 왜 node_modules 폴더가 디스크 공간을 사용하나요?#
pnpm은 전역 스토어에서 프로젝트의 node_modules 폴더로 hard links를 생성합니다. Hard links는 디스크상의 원본 파일이 있는 위치를 가리킵니다. 예를 들어, 프로젝트에 종속성으로 foo가 있고 1MB의 공간을 차지한다면, 프로젝트의 node_modules 폴더에서 1MB를 차지하고 전역 스토어에서도 같은 양의 공간을 차지하는 것처럼 보입니다. 하지만 그 1MB는 서로 다른 두 위치에서 참조되는 디스크 상의 동일한 공간입니다. 따라서 foo는 총 2MB가 아니라 1MB를 차지합니다.
이 주제에 대해 자세한 내용 (영어):
Windows에서 동작할까요?#
짧은 답: 네. 자세한 답변: Windows에서 심볼릭 링크를 사용하는 것은 때때로 문제가 될 수 있지만, pnpm에는 해결 방법이 있습니다. When pnpm cannot create symlinks on Windows (no Developer Mode or admin rights), it uses junctions instead.
하지만 중첩된 node_modules 방식은 Windows와 호환되지 않나요?#
초기 버전의 npm은 모든 node_modules를 중첩하는 방식 때문에 문제가 있었습니다(this issue 참조). 하지만, pnpm은 폴더를 깊이 생성하는 대신, 모든 패키지를 평평하게 저장하고 symbolic link를 사용해 종속성 트리 구조를 만듭니다.
순환 참조는 어떻습니까?#
비록 pnpm은 링크를 사용하여 종속성을 node_modules 폴더에 배치하지만, 상위 패키지가 해당 종속성이 있는 것과 동일한 node_modules 폴더에 배치되므로 순환 심볼릭 링크가 발생하지 않습니다. 따라서 foo의 종속성은 foo/node_modules에 있지 않으며, foo가 자신의 종속성과 함께 node_modules에 있습니다.
왜 하드 링크가 있습니까? 글로벌 스토어에 직접 심볼릭 링크하지 않는 이유는 무엇입니까?#
하나의 패키지는 하나의 시스템에 대해 서로 다른 의존성 집합을 가질 수 있습니다.
In project A foo@1.0.0 can have a dependency resolved to bar@1.0.0, but
in project B the same dependency of foo might resolve to bar@1.1.0; so,
pnpm hard links foo@1.0.0 to every project where it is used, to
create different sets of dependencies for it.
전역 스토어에 직접 심볼릭 링크하는 방식은 Node의 --preserve-symlinks 플래그와 함께 사용하면 작동하지만, 이 방식에는 자체적인 문제가 너무 많아 하드 링크를 계속 사용하기로 결정했습니다. 이 결정을 내린 이유에 대한 자세한 내용은 this issue를 참조하세요.
하나의 Btrfs 파티션 안의 서로 다른 서브볼륨 간에도 pnpm이 작동하나요?#
Btrfs는 단일 파티션 안의 서로 다른 서브볼륨 간에 장치 간 하드 링크를 허용하지 않지만, reflink는 허용합니다. As a result, pnpm uses reflinks to share data between these subvolumes.
여러 드라이브나 파일 시스템에서도 pnpm이 작동하나요?#
패키지 스토어는 설치 위치와 같은 드라이브 및 파일 시스템에 있어야 합니다. 그렇지 않으면 패키지는 링크되지 않고 복사됩니다. 이는 하드 링크의 작동 방식에 따른 제한 때문으로, 한 파일 시스템의 파일은 다른 파일 시스템의 위치를 가리킬 수 없습니다. 자세한 내용은 Issue #712를 참조하세요.
pnpm은 아래 2가지 경우에 다르게 작동합니다:
저장 경로가 지정된 경우#
If the store path is specified via storeDir, then copying
occurs between the store and any projects that are on a different disk.
디스크 A에서 pnpm install을 실행하는 경우, pnpm 스토어는 반드시 디스크 A에 있어야 합니다.
만약 pnpm 스토어가 디스크 B에 있으면 필요한 모든 패키지가 링크되는 대신 프로젝트 위치로 직접 복사됩니다. 이는 pnpm의 저장 공간 및 성능상 이점을 크게 저해합니다.
저장 경로가 지정되지 않은 경우#
스토어 경로를 설정하지 않으면 여러 개의 스토어가 생성됩니다(드라이브 또는 파일 시스템마다 하나씩).
pnpm uses <pnpm home>/store when the project can hardlink into it. Otherwise
it uses .pnpm-store at the root of the project's filesystem (the mount point),
or <project>/node_modules/.pnpm-store as a last resort. If later the installation is run on
disk B, an independent store will be created on B. 프로젝트는 여전히 pnpm의 이점을 유지하지만, 각 드라이브에 중복된 패키지가 있을 수 있습니다.
pnpm은 무엇의 약자인가요?#
pnpm은 performant npm의 약자입니다.
@rstacruz가 이 이름을 지었습니다.
pnpm이 <YOUR-PROJECT-HERE>에서 작동하지 않나요?#
대부분의 경우 종속성 중 하나가 package.json에 선언되지 않은 패키지를 필요로 한다는 의미입니다. 이는 평탄한 node_modules로 인해 발생하는 흔한 실수입니다. 이런 경우 이는 해당 종속성의 오류이며, 종속성이 수정되어야 합니다. 하지만 시간이 걸릴 수 있으므로, pnpm은 문제가 있는 패키지가 작동하도록 하는 해결 방법을 지원합니다.
해결 방법 1#
문제가 있는 경우 nodeLinker: hoisted 설정을 사용할 수 있습니다.
이는 npm이 생성하는 것과 유사한 평탄한 node_modules 구조를 생성합니다.
해결 방법 2#
다음 예시에서 종속성은 자체 종속성 목록에 iterall 모듈을 가지고 있지 않습니다.
버그가 있는 패키지의 누락된 종속성을 해결하는 가장 쉬운 방법은 프로젝트의 package.json에 iterall을 종속성으로 추가하는 것입니다.
pnpm add iterall로 설치하면 프로젝트의 package.json에 자동으로 추가됩니다.
"dependencies": {
...
"iterall": "^1.2.2",
...
}
해결 방법 3#
해결 방법 중 하나는 hooks를 사용하여 패키지의 package.json에 누락된 종속성을 추가하는 것입니다.
한 예로 pnpm에서 작동하지 않던 Webpack Dashboard가 있었습니다. 이후 이 문제가 해결되어 이제 pnpm에서 작동합니다.
예전에는 다음과 같은 오류가 발생했습니다:
Error: Cannot find module 'babel-traverse'
at /node_modules/inspectpack@2.2.3/node_modules/inspectpack/lib/actions/parse
문제는 babel-traverse가 webpack-dashboard에서 사용하는 inspectpack에서 사용되었지만, babel-traverse가 inspectpack의 package.json에 명시되지 않았다는 것이었습니다. npm과 yarn은 평탄한 node_modules를 생성하기 때문에 여전히 작동했습니다.
해결 방법은 다음 내용으로 .pnpmfile.mjs를 생성하는 것이었습니다:
export const hooks = {
readPackage: (pkg) => {
if (pkg.name === "inspectpack") {
pkg.dependencies['babel-traverse'] = '^6.26.0';
}
return pkg;
}
}
After creating a .pnpmfile.mjs, run pnpm install. pnpm detects the changed
pnpmfile and resolves the dependencies again. There is no need to delete
pnpm-lock.yaml or node_modules.
packageExtensions adds
a missing dependency without a pnpmfile.