Pnpm - 完全使用指南：自定义配置、管理 Nodejs 版本

安装

使用 Powershell 安装

Invoke-WebRequest https://get.pnpm.io/install.ps1 -UseBasicParsing | Invoke-Expression

终端输入 pnpm -v 输出对应版本号则表示安装成功

手动安装

1. 前往 Github Releases 手动下载 pnpm 可执行文件并重命名为 pnpm.exe
2. 将 pnpm.exe 放置在自定义目录（以 D:\Pnpm 为例）
3. 添加系统环境变量 %PNPM_HOME% 值为 D:\Pnpm
4. 在 Path 变量中添加 %PNPM_HOME%
5. 重启电脑以应用环境变量（windows 系统最好重启系统以更新环境变量）
6. 终端输入 pnpm -v 输出对应版本号则表示安装成功

配置相关安装路径

1. 例如将目录 D:\Pnpm 配置为 pnpm 的全局安装路径，配置如下：

   使用 Powershell 安装的 pnpm 会默认安装到路径 %USERPROFILE%\AppData\Local\pnpm 下，需将相关文件移动到自定义目录（D:\Pnpm）下

   

2. 依次运行

   pnpm config set global-bin-dir D:\Pnpm
   pnpm config set global-dir D:\Pnpm\global
   pnpm config set cache-dir D:\Pnpm\cache
   pnpm config set state-dir D:\Pnpm\state
   

   默认 pnpm 配置文件位于 %USERPROFILE%\AppData\Local\pnpm\config\rc 可手动修改

3. 配置环境变量

   检查是否已存在变量 %PNPM_HOME%，一般使用 Powershell 安装后会默认写入用户环境变量中，有则删除后续参考手动安装环境变量配置流程

4. pnpm c get 或 pnpm c list 检查配置是否正确

Npm 注册表镜像源配置

• pnpm config set registry https://registry.npmmirror.com/

• 或通过手动修改 %USERPROFILE%\AppData\Local\pnpm\config\rc 配置文件添加 registry=https://registry.npmmirror.com/

注意：使用 pnpm config set registry {url} 可能会将 registry 配置写入 %USERPROFILE%\.npmrc， 并不会写入 %USERPROFILE%\AppData\Local\pnpm\config\rc，pnpm 配置会优先应用 .npmrc 相关配置，后续若手动修改 %USERPROFILE%\AppData\Local\pnpm\config\rc 配置需注意（后续依然使用 pnpm config set registry {url} 则不影响，因为此命令依然会将 registry 写入 %USERPROFILE%\.npmrc）

使用 Pnpm 管理 Nodejs 版本

有了 Pnpm 完全不再需要使用 nvm fnm volta 等等其他工具了，完全可以使用 Pnpm 来管理 Nodejs 版本

Nodejs 安装镜像源配置

向 %USERPROFILE%\AppData\Local\pnpm\config\rc 配置文件中添加如下配置

node-mirror:release=https://npmmirror.com/mirrors/node/
node-mirror:rc=https://npmmirror.com/mirrors/node-rc/
node-mirror:nightly=https://npmmirror.com/mirrors/node-nightly/

Pnpm Settings NodeMirror

pnpm env <cmd>

此方式会将 nodejs 安装在 {global-bin-dir}\nodejs 目录，可参考如上配置安装路径

• pnpm env use --global lts 安装并使用 LTS 版本
• pnpm env use --global 22 安装指定版本
• pnpm env remove --global 22 移除指定版本
• pnpm env list 输出本地所有版本
• pnpm env list --remote 输出远程所有版本
• 更多使用方式请参考 Pnpm Env 管理 Node.js 环境

更新 Pnpm

官方推荐使用 pnpm self-update 更新，但是在某些情况下会更新失败

建议从 GitHub releases 下载最新可执行文件并替换旧版本可执行文件即可

如下将下载好的最新版本可执行文件重命名为 pnpm.exe 并在原目录进行替换

参考

Pnpm