pnpm add <pkg>
安裝一個套件與其所有依賴的套件。 預設狀況下,新安裝的套件將被視為生產環境依賴套件安裝。
TL;DR
命令 | 效果 |
---|---|
pnpm add sax | Save to dependencies |
pnpm add -D sax | Save to devDependencies |
pnpm add -O sax | Save to optionalDependencies |
pnpm add -g sax | 全域安裝該套件 |
pnpm add sax@next | Install from the next tag |
pnpm add sax@3.0.0 | Specify version 3.0.0 |
支援的套件位置
從 npm registry 安裝
pnpm add package-name
will install the latest version of package-name
from
the npm registry by default.
如果在工作區內執行此命令,此命令會先確認工作區中是否有其他專案也使用指定套件。 如果是,將會按已使用的版本範圍進行安裝。
您可以用下列方式安裝套件:
- tag:
pnpm add express@nightly
- version:
pnpm add express@1.0.0
- version range:
pnpm add express@2 react@">=0.1.0 <0.2.0"
從工作區安裝
Note that when adding dependencies and working within a workspace, packages
will be installed from the configured sources, depending on whether or not
link-workspace-packages
is set, and use of the
workspace: range protocol
.
從本機檔案系統安裝
有兩種方式可讓您從本機的檔案系統進行安裝:
- from a tarball file (
.tar
,.tar.gz
, or.tgz
) - 從一個資料夾
Examples:
pnpm add ./package.tar.gz
pnpm add ./some-directory
When you install from a directory, a symlink will be created in the current
project's node_modules
, so it is the same as running pnpm link
.
從遠端伺服器的 Tar 壓縮檔安裝
此參數必須是一個以 "http://" 或 "https://" 開頭並且可以被擷取的連結。
例如:
pnpm add https://github.com/indexzero/forever/tarball/v0.5.6
從 Git 儲存庫安裝
pnpm add <git remote url>
使用 Git 從代管的 Git 平台上複製並安裝套件。
您可以用特殊格式來指定平台、帳號及儲存庫。 For example,
pnpm add github:user/repo
您可以用下列方式自 Git 安裝:
- latest commit from master:
pnpm add kevva/is-positive
- commit:
pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678
- branch:
pnpm add kevva/is-positive#master
- version range:
pnpm add kevva/is-positive#semver:^2.0.0
You may also install just a subdirectory from a Git-hosted monorepo. 例如:
pnpm add myorg/repo#path:packages/foo
It is possible to combine multiple parameters by separating them with &
. For instance, you can extend the above command by specifying which branch to fetch from:
pnpm add myorg/repo#path:packages/foo&next
Options
--save-prod, -P
Install the specified packages as regular dependencies
.
--save-dev, -D
Install the specified packages as devDependencies
.
--save-optional, -O
Install the specified packages as optionalDependencies
.
--save-exact, -E
安裝套件並鎖定為指定版本,而不會使用 pnpm 預設的 semver 範圍
--save-peer
Using --save-peer
will add one or more packages to peerDependencies
and
install them as dev dependencies.
--ignore-workspace-root-check
Adding a new dependency to the root workspace package fails, unless the
--ignore-workspace-root-check
or -w
flag is used.
For instance, pnpm add debug -w
.
--global, -g
在全域空間安裝該套件
--workspace
僅新增可在工作區找到的新套件。