pnpm add <pkg>
패키지와 패키지가 의존하는 모든 패키지를 설치합니다. 기본적으로 새 패키지는 프로덕션 의존성으로 설치됩니다.
요약
| 명령어 | 의미 |
|---|---|
pnpm add sax | dependencies에 저장 |
pnpm add -D sax | devDependencies에 저장 |
pnpm add -O sax | optionalDependencies에 저장 |
pnpm add -g sax | 패키지를 전역으로 설치합니다 |
pnpm add sax@next | next 태그로부터 설치 |
pnpm add sax@3.0.0 | 3.0.0 버전 명시 |
지원되는 패키지 위치
npm 레지스트리에서 설치
pnpm add package-name은 기본적으로 npm registry에서 package-name의 최신 버전을 설치합니다.
워크스페이스에서 실행하는 경우, 명령은 먼저 워크스페이스에 있는 다른 프로젝트가 지정된 패키지를 사용하는지 여부를 확인합니다. 이 경우, 이미 사용된 버전이 설치됩니다.
다음을 통해 패키지를 설치할 수도 있습니다.
- 태그:
pnpm add express@nightly - 버전:
pnpm add express@1.0.0 - 버전 범위:
pnpm add express@2 react@">=0.1.0 <0.2.0"
Install from the JSR registry
Added in: v10.9.0
To install packages from the JSR registry, use the jsr: protocol prefix:
pnpm add jsr:@hono/hono
pnpm add jsr:@hono/hono@4
pnpm add jsr:@hono/hono@latest
This works just like installing from npm, but tells pnpm to resolve the package through JSR instead.
워크스페이스에서 설치하기
의존성을 추가하고 워크스페이스에서 작업할 때, link-workspace-packages의 설정 여부와 workspace: range protocol 프로토콜의 사용에 따라 설정된 소스로부터 패키지가 설치된다는 점에 유의하세요.
로컬 파일 시스템에서 설치
로컬 파일 시스템에서 설치하는 방법에는 두 가지가 있습니다.
- 타르볼 파일에서 설치 (
.tar,.tar.gz, or.tgz) - 디렉토리에서 설치
예시:
pnpm add ./package.tar.gz
pnpm add ./some-directory
디렉토리에서 설치하면 현재 프로젝트의 node_modules에서 심볼릭 링크가 생성되므로, pnpm link를 실행하는 것과 동일합니다.
원격 타르볼에서 설치
인수는 "http://" 또는 "https://"로 시작하는 가져올 수 있는 URL이어야 합니다.
예시:
pnpm add https://github.com/indexzero/forever/tarball/v0.5.6
Git 저장소에서 설치
pnpm add <git remote url>
Installs the package from the hosted Git provider, cloning it with Git.
You may install packages from Git by:
- Latest commit from default branch:
pnpm add kevva/is-positive
- Git commit hash:
pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678
- Git branch:
pnpm add kevva/is-positive#master
- Git branch relative to refs:
pnpm add zkochan/is-negative#heads/canary
- Git tag:
pnpm add zkochan/is-negative#2.0.1
- V-prefixed Git tag:
pnpm add andreineculau/npm-publish-git#v0.0.7
Install from a Git repository using semver
You can specify version (range) to install using the semver: parameter. 예시:
- Strict semver:
pnpm add zkochan/is-negative#semver:1.0.0
- V-prefixed strict semver:
pnpm add andreineculau/npm-publish-git#semver:v0.0.7
- Semver version range:
pnpm add kevva/is-positive#semver:^2.0.0
- V-prefixed semver version range:
pnpm add andreineculau/npm-publish-git#semver:<=v0.0.7
Install from a subdirectory of a Git repository
You may also install just a subdirectory from a Git-hosted monorepo using the path: parameter. 예를 들어:
pnpm add RexSkz/test-git-subdir-fetch#path:/packages/simple-react-app
Install from a Git repository via a full URL
If you want to be more explicit or are using alternative Git hosting, you might want to spell out full Git URL:
# git+ssh
pnpm add git+ssh://git@github.com:zkochan/is-negative.git#2.0.1
# https
pnpm add https://github.com/zkochan/is-negative.git#2.0.1
Install from a Git repository using hosting providers shorthand
You can use a protocol shorthand [provider]: for certain Git providers:
pnpm add github:zkochan/is-negative
pnpm add bitbucket:pnpmjs/git-resolver
pnpm add gitlab:pnpm/git-resolver
If [provider]: is omitted, it defaults to github:.
Install from a Git repository combining different parameters
It is possible to combine multiple parameters by separating them with &. This can be useful for forks of monorepos:
pnpm add RexSkz/test-git-subdir-fetch.git#beta\&path:/packages/simple-react-app
Installs from the beta branch and only the subdirectory at /packages/simple-react-app.
옵션
--save-prod, -P
지정된 패키지를 일반 dependencies로 설치합니다.
--save-dev, -D
지정된 패키지를 devDependencies로 설치합니다.
--save-optional, -O
지정된 패키지를 optionalDependencies로 설치합니다.
--save-exact, -E
저장된 의존성은 pnpm의 기본 semver 범위 연산자를 사용하지 않고 정확한 버전으로 구성됩니다.
--save-peer
--save-peer 를 사용하면 하나 이상의 패키지가 peerDependencies 에 추가되고 dev 의존성으로 설치됩니다.
--config
Added in: v10.8.0
Save the dependency to configDependencies.
--ignore-workspace-root-check
--ignore-workspace-root-check 또는 -w 플래그를 사용하지 않으면, 루트 워크스페이스 패키지에 새 의존성을 추가하는 데 실패합니다.
예를 들어, pnpm add debug -w 와 같이 사용할 수 있습니다.
--global, -g
패키지를 전역으로 설치합니다.
--workspace
워크스페이스에서 발견된 경우에만 새 의존성을 추가합니다.
--allow-build
Added in: v10.4.0
A list of package names that are allowed to run postinstall scripts during installation.
예시:
pnpm --allow-build=esbuild add my-bundler
This will run esbuild's postinstall script and also add it to the onlyBuiltDependencies field of pnpm-workspace.yaml. So, esbuild will always be allowed to run its scripts in the future.