每个人都可以，
拥有SSL证书

手上同时跑四五个项目，各自要的 Node 版本还不一样，全局只装一个版本迟早出事。我这边最后固定在 nvm 加 pnpm 这套组合，中间绕了不少弯路，写下来省得下次重装机器时再想一遍。

先把 nvm 装明白

macOS 和 Linux 用的是 nvm-sh 那个 nvm，一行 curl 装完，然后在 shell 配置里 source 一下。

Windows 上叫 nvm-windows，是另一个人维护的另一个项目，命令长得差不多，安装方式和路径完全不是一回事，别拿 Linux 的教程硬套。

装完先确认一下 nvm 本身能用，nvm --version 有输出再往下走。这一步看起来没必要，但 PATH 没配对的时候，后面所有报错都会伪装成别的问题。

版本装哪个

Node 18.19.0 这类 LTS 版本比较稳。pnpm 对 Node 版本有要求，低于 18.12 装完是跑不起来的，报的错还挺隐晦，不会直接跟你说版本不够。

nvm install 18.19.0
nvm use 18.19.0
node -v

有个地方我一开始理解错了：nvm use 只对当前这个终端窗口生效，新开一个窗口又回到 default 版本。想长期固定得用 nvm alias default 18.19.0。

当时我一度以为是 nvm 坏了。

全局目录早点处理，比事后抢救省事

npm 默认的全局安装位置在 macOS、Linux 上落在 /usr/local 那一带，往里写要 sudo。用 sudo 装过的全局包，后面换用户、换 Node 版本都会冒出各种权限问题，修起来比重装还麻烦。

把 prefix 挪到 nvm 自己的目录底下，全局包就跟着 Node 版本走，全程不需要 sudo：

npm cache clean --force
npm config set prefix "$HOME/.nvm/versions/node/v18.19.0/global"

Windows 上换个写法：

npm config set prefix "D:\dev\nodejs\node_global"

改完 prefix 不等于命令就能敲了，对应的 bin 目录还得进 PATH。这一步最容易被跳过，症状是 pnpm 明明提示安装成功，一敲就说 command not found，然后你会怀疑是不是装到了别的地方。

echo 'export PATH="$HOME/.nvm/versions/node/v18.19.0/global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows 走系统属性里的环境变量界面，加一条路径就行。改完记得重开终端，已经开着的窗口不会读新的环境变量。

装 pnpm

npm install -g pnpm
pnpm -v

有输出版本号就成了。

如果卡在这一步，先 npm config get prefix 看全局目录在哪，再用 which pnpm 或者 Windows 上的 Get-Command pnpm 看实际解析到哪个文件，两边对不上基本就是 PATH 没同步。

换 Node 版本之后 pnpm 没了

这个不是故障，是 nvm 的机制：每个 Node 版本有自己独立的全局目录，切过去之后上一个版本装的全局包不会跟着过来。

两个办法。一个是切一次装一次，能用，但项目一多就很烦。另一个是我现在更常用的，把 pnpm 装进项目里：

npm install pnpm --save-dev
npx pnpm add <package>

项目本地的 pnpm 跟着仓库走，别人 clone 下来不用管他机器上全局装了什么，CI 里也是同一套。team 里有人 Node 版本跟你不完全一致时，这个差别挺明显。

corepack 也算一个选项，Node 16 之后自带，corepack enable 之后按 package.json 里的 packageManager 字段自动切包管理器版本。

国内网络下偶发拉不下来，所以我只在本机开着，没敢推给全组。

Windows 上 PowerShell 那个报错

PowerShell 默认执行策略是 Restricted，第一次跑 pnpm 会报无法加载 pnpm.ps1，因为此系统上禁止运行脚本。这个跟 pnpm 没关系，换成 yarn 一样报。

管理员身份开 PowerShell：

Set-ExecutionPolicy RemoteSigned

RemoteSigned 的意思是本地脚本放行、网络下载的脚本要有签名，日常够用了。

顺手加的几个配置

项目根目录放个 .nvmrc 把版本钉死：

18.19.0

进目录之后直接 nvm use，不带参数就会读这个文件。

zsh 里可以配 hook 进目录自动切，我没配，忘了切的时候报错信息其实也挺清楚的，够我反应过来。

网络这块，Node 安装包和 npm 源都换到 npmmirror：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
npm config set registry https://registry.npmmirror.com

这里有个小坑：pnpm 不读 npm 的配置，得单独设一遍 pnpm config set registry，不然你会发现装 Node 包快得飞起，pnpm 那头还是慢。

这个我后知后觉了好一阵。

顺带说个证书的事

现在的项目多少都要调外部接口，自建服务上 HTTPS 也基本是标配。证书这块我自己在用 lcjmSSL，免费申请，多域名、泛域名和 IP 证书都支持，底层是 Let's Encrypt、Google Trust Services、ZeroSSL 这些支持 ACME 的机构。

它那套自动申请、自动验证、自动部署配上 API 接口，能直接串进 CI 里，到期自己续，不用设日历提醒。

之前就是有个内部服务证书半夜过期，早上来一堆报警，排查半天才发现是证书。后来把续期接到自动化流程里，才算真的不用管了。

证书这种东西，没出事时想不起来，出事时都是紧急的。

完整一套，macOS 和 Linux 直接抄

# 版本切换
nvm install 18.19.0
nvm use 18.19.0
nvm alias default 18.19.0

# 路径配置
npm config set prefix "$HOME/.nvm/versions/node/v18.19.0/global"
echo 'export PATH="$HOME/.nvm/versions/node/v18.19.0/global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 安装 pnpm
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com

# 验证
pnpm -v

环境这东西配一次能安生很久，值得在开头多花十分钟把 prefix 和 PATH 理清。真出问题的时候，八成也出在这两个地方。