一个专业的前端如何在国内安装 `pnpm`

孟陬2025-10-10 22:10

本文以 macOS 为例，但思路也适用于 Windows 系统。

对于 pnpm 我们有多种安装方式，可以使用现有的包管理器比如 npm npm i -g pnpm

但是 npm 一般是通过 nvm 安装的，如果 nvm 切换到其他 node.js 版本，则无法使用 pnpm（command not found: pnpm），还得继续安装一遍，颇为麻烦。

所以 pnpm 官方一般推荐通过 shell 脚本的方式安装，以下安装命令来自 pnpm 官网：pnpm.io/installatio...

sh 复制代码

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

但是如果直接运行我们会发现超时以及报错。通过下载安装脚本 get.pnpm.io/install.sh 和搜索关键词 github 我们在 94 行发现：

sh 复制代码

archive_url="https://github.com/pnpm/pnpm/releases/download/v${version}/pnpm-${platform}-${arch}"

原因很清楚了国内无法访问 github，修复也很简单找一个 proxy 即可，这里我用的是 gh-proxy.com/ （2025-09-27 可用）：

第一步：移除无用包

可选。主要是为了删除无用包，减少磁盘浪费，以及避免冲突。切换到曾经安装过 pnpm 的 node.js 版本。

perl 复制代码

nvm use 20
npm uninstall -g pnpm

第二步：替换成可用 proxy

将下载到本地的 install.sh 修改成如下：

sh 复制代码

archive_url="https://gh-proxy.com/https://github.com/pnpm/pnpm/releases/download/v${version}/pnpm-${platform}-${arch}"

然后执行：

复制代码

sh install.sh

等待 10s 即可安装成功，并且 .zshrc 文件末尾将自动增加：

sh 复制代码

# pnpm
export PNPM_HOME="/Users/legend80s/Library/pnpm"
case ":$PATH:" in
  *":$PNPM_HOME:"*) ;;
  *) export PATH="$PNPM_HOME:$PATH" ;;
esac
# pnpm end

重新开一个 terminal 让更新后的 .zshrc 生效或者直接 source .zshrc 然后，

试试 pnpm -v 输出 10.17.1（2025-09-27）。

再试试 pnpx pnpx ydd -e -s -c=a hefty。

一样成功 🎉。