跳到主要内容

安装

通过脚本安装

在 POSIX 类系统上,即使尚未安装 Node.js,也可以使用以下脚本安装 pnpm:

curl -fsSL https://get.pnpm.io/install.sh | PNPM_VERSION=7.0.0-rc.2 sh -

如果没有安装 curl,可以使用 wget:

wget -qO- https://get.pnpm.io/install.sh | PNPM_VERSION=7.0.0-rc.2 sh -

在 Windows 系统上(PowerShell):

$env:PNPM_VERSION='7.0.0-rc.2' ; iwr https://get.pnpm.io/install.ps1 -useb | iex

然后就可以使用 pnpm env 命令来安装 Node.js 了。

Using Corepack

Since v16.13, Node.js is shipping Corepack for managing package managers. This is an experimental feature, so you need to enable it by running:

corepack enable

This will automatically install pnpm on your system. However, it probably won't be the latest version of pnpm. To upgrade it, check what is the latest pnpm version and run:

corepack prepare pnpm@7.0.0-rc.2 --activate

使用 npm

npm install -g pnpm@next-7

使用 Homebrew 安装 pnpm

如果你已经安装了 Homebrew 软件包管理器,则可以使用如下命令赖安装 pnpm:

brew install pnpm

使用 Scoop 安装 pnpm

如果你已经安装了 Scoop,就可以通过一下命令安装 pnpm:

scoop install nodejs-lts pnpm

升级

一旦安装完 pnpm 之后,就无需使用其它软件包管理器来更新 pnpm 了。 你可以让 pnpm 自己来更新自己,如下所示:

pnpm add -g pnpm
tip

你是否需要在 CI 服务器上使用 pnpm?请参阅 持续集成 章节。

兼容性

以下列表列出了以往的 pnpm 版本和对应支持的 Node.js 版本。

Node.jspnpm 4pnpm 5pnpm 6pnpm 7
Node.js 10✔️✔️
Node.js 12✔️✔️✔️
Node.js 14✔️✔️✔️✔️
Node.js 16?️?️✔️✔️
Node.js 18?️?️✔️✔️

故障排查

如果 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.cmdpnpx.cmdpnpm 等)。 执行上述操作后,再重新安装 pnpm,应该就能用了。

卸载 pnpm

如果你需要从系统中删除 pnpm CLI 以及其写入到磁盘中的所有文件的话,请参阅 卸载 pnpm