如何在 Windows 系统中手动安装和配置 PNPM（2026 进阶版）

为什么选择 PNPM？#

在开始安装前，我们需要了解为什么 PNPM 被称为“表演者（Performant）”。与 NPM 和 Yarn 不同，PNPM 采用了一种基于 内容寻址（Content-addressable） 的文件系统存储方式。

节省磁盘空间：同一版本的包在磁盘上只存储一份。
安装极快：利用硬链接（Hard Links）技术，避免了重复文件的解压和拷贝。
严格的依赖树：防止项目意外访问未在 package.json 中声明的“幽灵依赖”。

1. 2026 推荐安装方式：官方独立安装#

虽然 npm install -g pnpm 很方便，但它依赖于现有的 Node.js 环境。如果你想获得更纯净的体验，推荐使用 PowerShell 脚本 进行独立安装：

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

安装完成后，关闭并重新打开终端，运行 pnpm -v 即可。

2. 手动配置与路径修复#

如果你已经通过 NPM 安装但发现命令无法识别，通常是因为 环境变量（PATH） 未正确指向 PNPM 的 Bin 目录。

方案 A：配置环境变量（推荐）#

不要盲目地拷贝文件到 Node.js 目录，正确做法是将 PNPM 的全局 Bin 路径添加到系统变量中。

获取全局安装路径：执行 npm config get prefix，假设输出为 E:\nodejs_global。
设置环境变量：

右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量。
在“用户变量”或“系统变量”的 Path 中，添加 ${your_prefix_path}。

方案 B：手动应急处理#

如果因为权限问题无法修改环境变量，可以采取你提到的“文件搬运”法：

定位到 pnpm 源码目录（通常在全局 node_modules/pnpm/bin 下）。
将其中的 pnpm.cmd 和 pnpm 脚本复制到 node.exe 所在的同级目录（例如 E:\Program Files\nodejs）。

3. 核心配置：自定义仓库与控制台#

安装成功后，为了防止 C 盘空间溢出，建议手动配置 PNPM 的存储路径（Store Path）：

1
# 设置全局存储路径（必须与项目在同一个驱动器以支持硬链接）
2
pnpm config set store-dir "E:\.pnpm-store"
3

4
# 设置全局安装路径
5
pnpm config set global-dir "E:\nodejs\pnpm\global"
6

7
# 设置状态路径
8
pnpm config set state-dir "E:\nodejs\pnpm\state"
9

10
# 设置缓存路径
11
pnpm config set cache-dir "E:\nodejs\pnpm\cache"

4. 常用命令快速参考#

操作	NPM 命令	PNPM 命令
安装依赖	`npm install`	`pnpm i`
添加包	`npm install <pkg>`	`pnpm add <pkg>`
移除包	`npm uninstall <pkg>`	`pnpm rm <pkg>`
运行脚本	`npm run <script>`	`pnpm <script>`
全局安装	`npm install -g <pkg>`	`pnpm add -g <pkg>`

5. 小结#

PNPM 是目前大型前端项目和 Monorepo（单仓多包）架构的首选。

优先使用官方脚本安装，避开环境冲突。
合理配置环境变量，保持 Node.js 目录整洁。
**务必配置 store-dir**，避免 C 盘被海量依赖项塞满。

通过这些优化，你的开发环境将变得更加高效、整洁。