安装
使用独立脚本
未预装 Node.js
在 POSIX 系统上,即使您没有安装 Node.js,您也可以使用以下脚本安装 pnpm:
curl -fsSL https://get.pnpm.io/install.sh | PNPM_VERSION=6.32.11 sh -
如果您没有安装 curl,也可以使用 wget:
wget -qO- https://get.pnpm.io/install.sh | PNPM_VERSION=6.32.11 sh -
在 Windows 下(使用PowerShell):
$env:PNPM_VERSION='6.32.11' ; iwr https://get.pnpm.io/install.ps1 -useb | iex
然后您可以使用 pnpm env 命令来安装 Node.js。
已预装 Node.js
在 Linux 或 macOS 下:
curl -f https://get.pnpm.io/v6.16.js | node - add --global pnpm@latest-6
在 Windows 下(使用PowerShell):
Invoke-WebRequest 'https://get.pnpm.io/v6.16.js' -UseBasicParsing -o pnpm.js; node pnpm.js add --global pnpm@6.32.11; Remove-Item pnpm.js
独立脚本已经经过签名。 如何验证?
使用 HomeBrew
如果您安装了包管理器,则可以使用以下命令安装 pnpm:
brew install pnpm
使用 Scoop
如果您安装了 Scoop ,您可以使用以下命令安装 pnpm:
scoop install nodejs-lts pnpm
使用 Corepack
从 v16.13 开始,Node.js 发布了 Corepack 来管理包管理器。 这是一项实验性功能,因此您需要通过运行如下脚本来启用它:
corepack enable
这将自动在您的系统上安装 pnpm。 但是,它可能不是最新版本的 pnpm。 要升级它,请检查最新的 pnpm 版本并运行:
corepack prepare pnpm@6.32.11 --activate
通过 npm 安装
npm install -g pnpm@latest-6
通过 npx 安装
npx pnpm add -g pnpm
升级
一旦你安装了 pnpm,就无需再使用其他软件包管理器进行升级。 你可以使用 pnpm 升级自己,像这样:
pnpm add -g pnpm
提示
你希望在 CI 服务器上使用 pnpm 吗? 参阅:持续集成。
兼容性
以下是各版本 pnpm 与各版本 Node.js 之间的支持表格。
Node.js | pnpm 1 | pnpm 2 | pnpm 3 | pnpm 4 | pnpm 5 | pnpm 6 |
---|---|---|---|---|---|---|
Node.js 4 | ✔️ | ❌ | ❌ | ❌ | ❌ | ❌ |
Node.js 6 | ✔️ | ✔️ | ❌ | ❌ | ❌ | ❌ |
Node.js 8 | ✔️ | ✔️ | ✔️ | ❌ | ❌ | ❌ |
Node.js 10 | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ❌ |
Node.js 12 | ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ |
Node.js 14 | ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ |
Node.js 16 | ? | ? | 未知 | 未知 | 未知 | ✔️ |
故障排查
如果 pnpm 损坏并且您无法通过重新安装来修复它,您可能需要从 PATH 中将其手动删除。
假设您在运行 pnpm install
时遇到以下错误:
C:\src>pnpm install
internal/modules/cjs/loader.js:883
throw err;
^
Error: Cannot find module 'C:\Users\Bence\AppData\Roaming\npm\pnpm-global\4\node_modules\pnpm\bin\pnpm.js'
←[90m at Function.Module._resolveFilename (internal/modules/cjs/loader.js:880:15)←[39m
←[90m at Function.Module._load (internal/modules/cjs/loader.js:725:27)←[39m
←[90m at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:72:12)←[39m
←[90m at internal/main/run_main_module.js:17:47←[39m {
code: ←[32m'MODULE_NOT_FOUND'←[39m,
requireStack: []
}
首先,尝试通过运行: which pnpm
来找到 pnpm 的位置。 如果您使用的是 Windows,请在 Git Bash 中运行此命令。 您将获得 pnpm 命令的位置,例如:
$ which pnpm
/c/Program Files/nodejs/pnpm
现在您应该已经知道了 pnpm CLI 的所在目录。打开该目录并删除所有与 pnpm 相关的文件(如pnpm.cmd
、 pnpx.cmd
、 pnpm
等)。 完成后,再次安装 pnpm。现在,它应该正按照预期工作。
卸载 pnpm
如果您需要从系统中卸载 pnpm CLI 并移除磁盘中的相关文件,请查阅 卸载 pnpm。