安装pnpm从是什么到如何操作的全面指南

【安装pnpm】核心疑问与操作详解

pnpm 是一个快速、节省磁盘空间的包管理器。如果您正在考虑或已经决定使用 pnpm 来管理您的项目依赖，那么首先需要将其安装到您的系统中。本文将围绕安装 pnpm 这一主题，详细解答您可能遇到的各种疑问，并提供详细的操作步骤。

pnpm 是什么？（聚焦安装和功能）

在考虑安装一个工具之前，了解它是什么以及它主要做什么是非常重要的。简单来说，pnpm 是 Node.js 的一个替代包管理器，类似于 npm 或 yarn。然而，pnpm 采用了一种独特的方式来管理项目的依赖项，这直接影响了它的安装过程以及安装后您的磁盘空间使用情况和依赖管理效率。

内容可寻址存储（Content-Addressable Store）： pnpm 的核心在于它的共享存储机制。无论您在系统中安装多少项目，如果它们依赖于相同版本的库，这个库只会真正在磁盘上存储一次。后续安装同样依赖时，pnpm 会从这个共享存储中创建硬链接（hard links）到项目的 node_modules 目录。
依赖扁平化与符号链接： 与 npm v3+ 或 yarn v1 的扁平化 node_modules 结构不同，pnpm 使用符号链接（symbolic links）来构建 node_modules 目录结构。这使得项目的依赖关系更加清晰和严格，有助于避免幽灵依赖（phantom dependencies）问题，即项目能够使用并未直接声明在 package.json 中的依赖。

因此，安装 pnpm 的意义在于获得一个能够更高效管理 Node.js 包的工具，为后续的项目开发打下基础。

为什么要安装 pnpm？（聚焦安装后的收益）

选择安装 pnpm 而非继续使用 npm 或 yarn 主要基于其带来的显著优势：

安装速度快： 由于利用硬链接和内容可寻址存储，pnpm 在安装依赖时避免了大量的复制操作，尤其是在已有共享存储缓存的情况下，安装速度通常比 npm 和 yarn 快很多。这意味着您可以更快地开始您的项目或CI/CD流程。
极大地节省磁盘空间： 如前所述，相同版本的依赖只存储一次，这对于在同一台机器上管理大量项目或拥有许多重复依赖的项目来说，能节省巨大的磁盘空间。这减轻了本地开发环境或构建服务器的存储压力。
更严格的依赖管理： pnpm 的 node_modules 结构更严格地反映了项目的依赖关系，有助于发现和修复项目中对未声明依赖的隐式依赖，从而使项目更健壮、更容易维护。

安装 pnpm 就是为了获得这些实际的、面向开发效率和资源效率的收益。

从哪里可以获取和安装 pnpm？

获取 pnpm 有多种官方推荐或常用的渠道：

官方推荐的独立安装脚本： pnpm 官方提供了一个专用的安装脚本，这是最推荐的方式，因为它会将 pnpm 安装到一个独立的位置，由 pnpm 自己管理，避免与通过 npm 或 yarn 安装的其他全局包冲突。
使用 npm 或 yarn： 您也可以通过 npm 或 yarn 全局安装 pnpm，但这不是 pnpm 团队推荐的方式，因为它可能导致一些版本管理上的问题。
系统包管理器： 对于 macOS 和 Linux 用户，可以使用 Homebrew；对于 Windows 用户，可以使用 Chocolatey 或 Scoop。这些包管理器可以方便地安装和管理 pnpm，并与其他系统工具集成。
手动下载二进制文件： pnpm 也提供预编译的二进制文件供下载，但这通常只推荐给高级用户或自动化脚本使用。

至于 pnpm 会被安装到系统的哪个位置，这取决于您使用的安装方法：

独立脚本安装： 通常会安装到用户主目录下的某个隐藏文件夹中，例如 ~/.local/share/pnpm 或 ~/.pnpm。安装脚本会自动将 pnpm 的可执行文件路径添加到您的系统 PATH 环境变量中，以便您可以在任何地方直接运行 pnpm 命令。
npm/yarn 全局安装： 会安装到 npm 或 yarn 配置的全局包安装目录下。这个目录的位置因系统和配置而异，但通常也在用户主目录下或系统目录中。同样，这个目录需要包含在系统 PATH 中。
系统包管理器安装： 会安装到包管理器配置的标准安装路径下，并由包管理器负责管理 PATH。

共享的内容可寻址存储（存储实际依赖文件的地方）默认也位于用户主目录下的某个位置，例如 ~/.pnpm-store。这个位置可以通过配置进行修改。

安装 pnpm 需要多少资源？

关于安装 pnpm 所需的资源，可以从几个方面来看：

磁盘空间： pnpm 工具本身占用的空间非常小，通常只有几十兆字节。安装依赖时，pnpm 会创建共享存储。这个存储的大小取决于您安装的依赖种类和版本数量。虽然单个库只存储一次，但随着您开发的项目增多，依赖种类增加，存储也会增大。然而，相比于 npm 或 yarn 在每个项目都完整复制所有依赖的方式，pnpm 的总磁盘空间占用通常会显著减少。
安装方法数量： 如上所述，主要的安装方法有 4 种（独立脚本、npm/yarn、系统包管理器、手动下载）。最推荐和最常用的方法是独立脚本安装。
安装所需时间： 安装 pnpm 工具本身通常非常快，只需几秒钟到一两分钟，这取决于您的网络速度和系统性能。第一次使用 pnpm 安装项目依赖时，由于需要填充共享存储，可能会花费一些时间，但这仍然通常比 npm/yarn 快。后续安装或安装已知依赖时，速度优势会更明显。

总的来说，安装 pnpm 对系统资源的即时消耗非常低，其设计反而旨在长期节省磁盘空间并提升效率。

如何以及如何开始安装 pnpm？（详细操作步骤）

这是本文的核心部分，将详细介绍几种主要的安装方法。

方法一：使用官方推荐的独立安装脚本 (推荐)

这是最推荐的方式，因为它最稳定，且由 pnpm 团队直接维护。它会自动设置 PATH，并让 pnpm 自己管理自己的版本。

首先，您需要确保系统中安装了 Node.js (建议使用 Node.js 16 或更高版本)。

打开终端或命令行工具：

在 macOS 或 Linux 上，打开 Terminal 或 iTerm 等。
在 Windows 上，打开 Command Prompt, PowerShell, 或 Git Bash。
运行安装命令：

根据您的操作系统和偏好，选择以下任一命令：

对于 macOS / Linux (使用 curl)：

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

对于 macOS / Linux (使用 wget)：

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

对于 Windows (使用 PowerShell)：

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

这些脚本会下载 pnpm 的最新版本并安装到您的用户目录下，然后尝试自动修改您的 shell 配置文件（如 ~/.bashrc, ~/.zshrc, ~/.profile 等）以将 pnpm 的 bin 目录添加到 PATH 环境变量中。
重启终端或刷新配置文件：

安装脚本修改 PATH 后，通常需要关闭并重新打开您的终端窗口，或者手动运行命令来加载更新后的配置文件（例如 source ~/.zshrc 或 . ~/.bashrc，具体取决于您使用的 shell）。
验证安装：

运行 pnpm --version 或 pnpm -v 命令。如果安装成功，将显示当前安装的 pnpm 版本号。

方法二：使用 npm 或 yarn 全局安装 (不推荐，仅作了解)

虽然不推荐，但这是一种简单快速的方式。请注意，使用这种方法安装的 pnpm 实际是作为 npm 或 yarn 的全局包存在的。

打开终端或命令行工具。
运行安装命令：

使用 npm：npm install -g pnpm
使用 yarn (v1): yarn global add pnpm

您可能需要管理员权限（在 Linux/macOS 上使用 sudo）来执行全局安装，但这通常意味着您的 npm/yarn 全局安装目录权限设置有问题。推荐修复权限问题而非使用 sudo。然而，更推荐的方式是使用独立脚本安装 pnpm 来避免这类权限和版本管理问题。
验证安装：

运行 pnpm --version 或 pnpm -v。

方法三：使用系统包管理器安装

如果您习惯使用 Homebrew (macOS/Linux), Chocolatey (Windows) 或 Scoop (Windows) 来管理系统上的工具，也可以通过它们来安装 pnpm。

对于 macOS / Linux (使用 Homebrew):

首先确保您已经安装了 Homebrew。
运行命令：brew install pnpm
对于 Windows (使用 Chocolatey):

首先确保您已经安装了 Chocolatey。
以管理员身份打开 PowerShell 或 Command Prompt，运行命令：choco install pnpm
对于 Windows (使用 Scoop):

首先确保您已经安装了 Scoop。
运行命令：scoop install pnpm

这些包管理器会自动处理下载、安装和配置 PATH 的过程。安装完成后，同样运行 pnpm --version 进行验证。

安装后如何验证 pnpm 是否成功安装？

无论您使用哪种方法安装，验证步骤都是相同的：

打开新的终端或命令行窗口。
输入命令：pnpm --version 或 pnpm -v
按下回车键。

如果安装成功且 PATH 配置正确，您将看到类似 8.15.4 (版本号会根据您安装的实际版本而变化) 的输出。如果看到 “command not found” 或类似的错误信息，通常意味着 pnpm 的安装路径没有正确添加到系统的 PATH 环境变量中，或者您没有重启终端。

如何更新已安装的 pnpm 版本？

更新 pnpm 的方法取决于您最初是如何安装它的：

如果使用独立安装脚本：

这是最方便的更新方式。打开终端，运行 pnpm 命令来更新自己：

pnpm add -g pnpm

或者使用其环境管理命令（推荐安装脚本方式使用这个来管理 Node.js 和 pnpm 版本）：

pnpm env setup (确保环境已设置)
pnpm env use --global latest (安装并使用最新的 Node.js 和捆绑的 pnpm)
如果使用 npm 或 yarn 全局安装：

使用原有的包管理器进行更新：

使用 npm：npm update -g pnpm
使用 yarn (v1): yarn global upgrade pnpm
如果使用系统包管理器安装：

使用对应的包管理器的更新命令：

Homebrew：brew upgrade pnpm
Chocolatey：choco upgrade pnpm
Scoop：scoop update pnpm

更新后，再次运行 pnpm --version 验证版本。

如果需要，如何卸载 pnpm？

卸载方法同样取决于安装方式：

如果使用独立安装脚本：

可以尝试运行卸载脚本 (具体脚本可能随版本变化，请查阅官方文档)。或者，您可以手动删除安装目录 (通常在用户主目录下，例如 ~/.local/share/pnpm 或 ~/.pnpm) 以及从您的 shell 配置文件中删除 pnpm 添加的 PATH 相关的行。如果使用 pnpm add -g pnpm 安装的，也可以尝试 pnpm remove -g pnpm。

请注意，卸载 pnpm 工具本身并不会删除共享的内容可寻址存储 (~/.pnpm-store)。如果您想彻底清理，需要手动删除这个存储目录。请谨慎操作，删除存储意味着所有项目需要重新安装依赖。
如果使用 npm 或 yarn 全局安装：

使用原有的包管理器进行卸载：

使用 npm：npm uninstall -g pnpm
使用 yarn (v1): yarn global remove pnpm
如果使用系统包管理器安装：

使用对应的包管理器的卸载命令：

Homebrew：brew uninstall pnpm
Chocolatey：choco uninstall pnpm
Scoop：scoop uninstall pnpm

卸载后，关闭并重新打开终端，运行 pnpm --version 应该会提示 “command not found”。

如何安装或切换到特定版本的 pnpm？

如果您需要安装旧版本或在不同 pnpm 版本之间切换，方法取决于安装方式：

如果使用独立安装脚本：

独立安装脚本捆绑了 pnpm env 命令，可以用来管理 Node.js 和 pnpm 版本。

安装特定版本的 Node.js (它会自带一个兼容的 pnpm 版本)：

pnpm env use --global (例如 pnpm env use --global 18.17.1)

这会下载并安装指定版本的 Node.js 和 pnpm，并将其设置为全局默认使用。
如果使用 npm 或 yarn 全局安装：

可以在安装命令中指定版本号：

使用 npm：npm install -g pnpm@ (例如 npm install -g [email protected])
使用 yarn (v1): yarn global add pnpm@
如果使用系统包管理器安装：

系统包管理器通常默认安装最新版本，或提供安装特定版本的选项（但不如独立脚本或 npm/yarn 灵活）。请查阅对应包管理器的文档。

安装或切换后，务必验证当前激活的 pnpm 版本是否正确。

安装过程中遇到问题怎么办？（常见问题和排查方向）

安装 pnpm 过程中可能会遇到一些常见问题：

“pnpm: command not found”：

这是最常见的问题，表明 pnpm 可执行文件所在的目录不在系统的 PATH 环境变量中。

排查：
- 确保安装脚本已成功运行。
- 检查您的 shell 配置文件 (如 ~/.bashrc, ~/.zshrc, ~/.profile, Windows 环境变量设置) 是否包含了 pnpm bin 目录的路径。如果使用独立脚本安装，路径通常类似 /Users/your_user/.local/share/pnpm 或 /home/your_user/.local/share/pnpm 下的一个 bin 目录。
- 关闭并重新打开终端，或使用 source 命令（例如 source ~/.zshrc）重新加载配置文件。
- 如果使用 npm/yarn 全局安装，检查 npm/yarn 的全局安装目录是否在 PATH 中。
权限错误 (EACCES 等)：

这通常在使用 npm/yarn 进行全局安装时遇到，表明当前用户没有权限向全局安装目录写入文件。

排查：
- 强烈推荐： 改用官方独立安装脚本，它通常将 pnpm 安装到用户目录下，不需要管理员权限。
- 如果必须使用 npm/yarn 全局安装：
  - 修复 npm 的默认目录权限 (查阅 npm 官方文档关于 Fixing npm permissions)。
  - 避免使用 sudo npm install -g pnpm，这可能导致后续权限问题。
网络问题：

下载安装脚本或 pnpm 包时可能遇到网络连接问题。

排查：
- 检查网络连接是否正常。
- 检查是否有防火墙或代理阻止了访问。如果需要，配置代理环境变量 (HTTP_PROXY, HTTPS_PROXY)。
与其他工具冲突：

特别是当通过 npm/yarn 全局安装 pnpm 时，如果在某个项目中使用 pnpm，而该项目的 Node.js 版本是通过 nvm, nvs 等工具管理并通过 npm 安装了其他全局包，可能会出现问题。

排查：
- 这是官方推荐使用独立安装脚本的主要原因之一。独立脚本安装的 pnpm 不依赖于特定的 Node.js 版本或 npm/yarn 全局环境。

如果在尝试了上述方法后仍然遇到问题，查阅 pnpm 的官方文档是获取最新和最详细帮助的最佳途径。

总结

安装 pnpm 是开始利用其高效包管理优势的第一步。了解其“是什么”和“为什么”能帮助您理解选择 pnpm 的价值，而掌握“哪里”、“多少”以及最重要的“如何/怎么”进行安装、验证、更新和卸载，则能确保您顺利地将其集成到您的开发工作流程中。推荐使用官方提供的独立安装脚本进行安装，以获得最佳的兼容性和易用性。一旦安装成功，您就可以在您的项目中使用 pnpm install, pnpm add, pnpm remove 等命令来管理依赖，体验其带来的速度和效率提升。

安装pnpm