跳至主要內容
版本:7.x

pnpm add <模組名稱>

安裝一個模組與其所有依賴套件。 預設狀況下,所有模組會被視為 production 依賴套件安裝。

命令簡要

命令意思
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 模組名稱 預設會從 npm 安裝 模組名稱的最新模組。

如果在工作區內執行此命令,此指令會先確認是否工作區中有其他專案使用指定模組。 如果有,就使用已使用的版本範圍進行安裝。

您也可以透過以下命令安裝模組:

  • 版本標籤:pnpm add express@nightly
  • 版本號碼:pnpm add express@1.0.0
  • 指定版本範圍:pnpm add express@2 react@">=0.1.0 <0.2.0"

從工作區安裝

需要注意的是,當您從工作區新增依賴模組時,依賴模組會從已設定的來源進行安裝,當然,這取決於 link-workspace-packages 是否有被設定,還有是否有使用 workspace: range protocol

從電腦上安裝

總共有以下兩種方法讓您從電腦上安裝:

  1. 從 Tar 格式壓縮檔(.tar, .tar.gz, or .tgz
  2. 從一個資料夾

例如:

pnpm add ./package.tar.gz
pnpm add ./some-directory

當您從資料夾進行安裝時,會在目前專案的 node_modules 資料夾下建立軟連結,所以結果和執行 pnpm link 命令的效果是一樣的

從遠端控制安裝Tar格式壓縮檔案

此參數必須是一個以"http://"或"https://"開頭並且可以被抓取的連結

例如:

pnpm add https://github.com/indexzero/forever/tarball/v0.5.6

從 Git 儲存庫安裝

pnpm add <Git Remote 連結>

使用 Git 從指定 Git 平台上複製指定模組專案並安裝。 您也可以使用指定格式指定平台、模組作者與模組。 例如:pnpm add github:user/repo

您可以透過以下命令從 Git 安裝模組:

  • master分支的最新提交:pnpm add kevva/is-positive
  • 從指定提交:pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678
  • 從指定分支:pnpm add kevva/is-positive#master
  • 從指定版本範圍:pnpm add kevva/is-positive#semver:^2.0.0

參數選項

--save-prod, -P

將指定模組視為平常的 dependencies 安裝

--save-dev, -D

將指定模組視為 devDependencies 安裝

--save-optional, -O

將指定模組視為 optionalDependencies 安裝

--save-exact, -E

安裝的依賴模組會被鎖定為指定版本,而不會使用 pnpm 預設的 semver range operator 設定

--save-peer

使用 --save-peer 會將一或多個模組新增至peerDependencies 並且將那些模組視為 dev dependencies 安裝

--ignore-workspace-root-check

除非使用 --ignore-workspace-root-check 或者 -w 參數,否則將新依賴模組新增至根工作區將會失敗

例如:pnpm add debug -w

--global, -g

將該依賴模組安裝至全域模組資料夾.

--workspace

只新增能在工作區找到的新模組

--filter <模組選擇器>

了解更多關於過濾的內容