安装

使用独立脚本

即使没有安装 Node.js,也可以使用以下脚本安装 pnpm。

Windows

使用 PowerShell:

  1. iwr https://get.pnpm.io/install.ps1 -useb | iex

在 POSIX 系统上

  1. curl -fsSL https://get.pnpm.io/install.sh | sh -

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

  1. wget -qO- https://get.pnpm.io/install.sh | sh -

在 Alpine Linux 上

  1. # bash
  2. wget -qO- https://get.pnpm.io/install.sh | ENV="~/.bashrc" SHELL="$(which bash)" bash -
  3. # sh
  4. wget -qO- https://get.pnpm.io/install.sh | ENV="~/.shrc" SHELL="$(which sh)" sh -
  5. # dash
  6. wget -qO- https://get.pnpm.io/install.sh | ENV="~/.dashrc" SHELL="$(which dash)" dash -

先决条件

如果您不使用独立脚本来安装 pnpm,那么您需要在您的系统上安装 Node.js(至少 v14)。

安装特定版本

在运行安装脚本之前,您可以选择设置环境变量 PNPM_VERSION 来安装特定版本的 pnpm:

  1. curl -fsSL https://get.pnpm.io/install.sh | env PNPM_VERSION=<version> sh -

安装 - 图1提示

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

使用 Corepack

从 v16.13 开始,Node.js 发布了 Corepack 来管理包管理器。 这是一项实验性功能,因此您需要通过运行如下脚本来启用它:

  1. corepack enable

如果您使用 Homebrew 安装 Node.js,则需要单独安装 corepack:

  1. brew install corepack

这将自动在您的系统上安装 pnpm。 但是,它可能不是最新版本的 pnpm。 若要升级,请检查 最新的 pnpm 版本 并运行:

  1. corepack prepare pnpm@<version> --activate

使用 Node.js v16.17 或更高版本,您只需指定标签即可安装 最新 版本的 pnpm:

  1. corepack prepare pnpm@latest --activate

通过 npm 安装

  1. npm install -g pnpm

使用 HomeBrew

如果您安装了包管理器,则可以使用以下命令安装 pnpm:

  1. brew install pnpm

使用 Scoop

如果您安装了 Scoop ,您可以使用以下命令安装 pnpm:

  1. scoop install nodejs-lts pnpm

安装 - 图2提示

你希望在 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时遇到以下错误:

  1. C:\src>pnpm install
  2. internal/modules/cjs/loader.js:883
  3. throw err;
  4. ^
  5. Error: Cannot find module 'C:\Users\Bence\AppData\Roaming\npm\pnpm-global\4\node_modules\pnpm\bin\pnpm.js'
  6. ←[90m at Function.Module._resolveFilename (internal/modules/cjs/loader.js:880:15)←[39m
  7. ←[90m at Function.Module._load (internal/modules/cjs/loader.js:725:27)←[39m
  8. ←[90m at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:72:12)←[39m
  9. ←[90m at internal/main/run_main_module.js:17:47←[39m {
  10. code: ←[32m'MODULE_NOT_FOUND'←[39m,
  11. requireStack: []
  12. }

首先,尝试通过运行: which pnpm来找到 pnpm 的位置。 如果您使用的是 Windows,请在 Git Bash 中运行此命令。 您将获得 pnpm 命令的位置,例如:

  1. $ which pnpm
  2. /c/Program Files/nodejs/pnpm

现在您应该已经知道了 pnpm CLI 的所在目录。打开该目录并删除所有与 pnpm 相关的文件(如pnpm.cmdpnpx.cmdpnpm等)。 完成后,再次安装 pnpm。现在,它应该正按照预期工作。

使用较短的别名

pnpm 可能很难输入,因此您可以使用较短的别名,例如 pn

在 POSIX 系统上添加永久别名

只需将下面这行放入 .bashrc.zshrcconfig.fish中:

  1. alias pn=pnpm
  2. source ~/. zshrc or ~/. bash_profile

在 Powershell (Windows) 中添加永久别名:

在具有管理员权限的 Powershell 窗口中,执行:

  1. notepad $profile.AllUsersAllHosts

profile.ps1 文件里加入:

  1. set-alias -name pn -value pnpm

保存文件然后关闭窗口。 您可能需要关闭任何打开的 Powershell 窗口才能使别名生效。

卸载 pnpm

如果您需要从系统中卸载 pnpm CLI 并移除磁盘中的相关文件,请查阅 卸载 pnpm