跳至主要內容
版本：下一個

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 的套件

支援的套件來源​

pnpm 支援從多種來源安裝套件。 參見 支援的套件來源 頁面以獲得更多資訊：

  • npm 登錄檔
  • JSR 登錄檔
  • 工作區套件
  • 本地檔案系統（tarball 與目錄）
  • 遠端的 tarballs
  • Git 倉庫（包含語義化版本、子目錄等）

參數​

--save-prod, -P, -p​

安裝套件至 dependencies

--save-dev, -D, -d​

安裝套件至 devDependencies

--save-optional, -O, -o​

安裝套件至 optionalDependencies

--save-exact, -E, -e​

安裝套件並鎖定為指定版本，而不會使用 pnpm 預設的 semver 範圍

--save-peer​

使用 --save-peer 將會新增一個或多個套件至 peerDependencies 並且將它們當作開發依賴套件進行安裝。

--save-catalog​

新增於 v10.12.1

將新的依賴套件儲存到預設 目錄 中。

--save-catalog-name <catalog_name>​

新增於 v10.12.1

將新的依賴套件儲存至指定 目錄 中。

--config​

新增於 v10.8.0

將依賴儲存至 configDependencies。

--ignore-workspace-root-check​

除非加上 --ignore-workspace-root-check 或 -w 參數，否則在工作區的根目錄中新增依賴套件時將會失敗。

例如：pnpm add debug -w。

--global, -g​

在全域空間安裝該套件

--workspace​

僅新增可在工作區找到的新套件。

--allow-build​

新增於 v10.4.0

一份允許在安裝期間執行安裝後腳本的套件清單。

例如：

pnpm --allow-build=esbuild add my-bundler

This will run esbuild's postinstall script and also add it to the allowBuilds field of pnpm-workspace.yaml. 因此，esbuild 將來總是被允許執行腳本。

--filter <package_selector>​

閱讀更多關於篩選的內容。

--cpu=<name>​

新增於 v10.14.0

Override CPU architecture of native modules to install. Acceptable values are same as cpu field of package.json, which comes from process.arch.

--os=<name>​

新增於 v10.14.0

Override OS of native modules to install. Acceptable values are same as os field of package.json, which comes from process.platform.

--libc=<name>​

新增於 v10.14.0

Override libc of native modules to install. Acceptable values are same as libc field of package.json.