② Windows（原生 CMD/PowerShell）
别硬杠，直接上社区维护版 nvm-windows：

winget install CoreyButler.NVMforWindows
# 装完后记得
nvm on   # 启用版本管理

━━━━━━━━━━━━━━━
📚 日常 9 招：从“能跑”到“飞起”
━━━━━━━━━━━━━━━
1. 安装最新 LTS

nvm install --lts
nvm alias default node # 设置全局默认

1. 批量“一锅端”

for v in 14.21.3 16.20.2 18.18.2 20.9.0; do nvm install $v; done

1. .nvmrc 自动切换
   项目根目录执行

node -v > .nvmrc   # 把当前版本写死

以后进目录

cd my-project
nvm use            # 自动读取 .nvmrc

搭配 zsh 可再进阶：

# ~/.zshrc 末尾加
autoload -U add-zsh-hook
load-nvmrc() {
  if [[ -f .nvmrc && -r .nvmrc ]]; then
    nvm use >/dev/null 2>&1
  fi
}
add-zsh-hook chpwd load-nvmrc

实现「切目录 → 秒切版本」的丝滑体验。

1. 全局模块“搬家”

nvm use 18
nvm install-latest-npm  # 让 npm 升到官方推荐版
npm i -g pnpm yarn ts-node
# 换版本后重新安装一次即可，沙盒隔离不再打架

1. 清理“磁盘杀手”

nvm list               # 看所有版本
nvm uninstall 12.22.0  # 一键删，连全局模块一起消失

1. 速度太慢？镜像安排

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
nvm install --lts

1. CI/CD 动态矩阵
   GitHub Actions 示例：

strategy:
  matrix:
    node: [14, 16, 18, 20]
steps:
  - uses: actions/setup-node@v4
    with:
      node-version: ${{ matrix.node }}

本地测试同样一条命令：

nvm use 14 && npm test
nvm use 20 && npm test

1. 调试 corepack
   Node 18+ 自带 corepack，用 nvm 切换版本后，corepack 会随版本激活/禁用，方便测试 pnpm/yarn berry 新特性。

2. 版本别名“语义化”

nvm alias qa 16.20.2
nvm alias dev 18.18.2
nvm use qa   # 再也不用背数字

━━━━━━━━━━━━━━━
🧪 高阶玩法：把 nvm 做成“团队基础设施”
━━━━━━━━━━━━━━━
① 强制统一：package.json 里加

"engines": {
  "node": ">=16.20.0 <19.0.0",
  "npm": ">=8.0.0"
}

配合 .nvmrc 锁定小版本，CI 与本地双向校验，再也不怕“我这边正常”。

② Docker 友好：
多阶段构建时，把 .nvmrc 写进镜像，ARG 动态传入：

ARG NODE_VERSION=18.18.2
FROM node:${NODE_VERSION}-alpine

本地 nvm use、CI docker build --build-arg NODE_VERSION=$(cat .nvmrc)，版本口径 100% 一致。

③ Monorepo 利器：
Nx、Lerna、pnpm workspace 支持不同 package 各自指定 Node，工具链用 nvm 动态切，脚本里加

nvm use $(cat apps/legacy/.nvmrc)

即可让「老古董」与「新旗舰」共存一个仓库。

━━━━━━━━━━━━━━━
⚠️ 10 年踩坑总结：这些红线别碰
━━━━━━━━━━━━━━━
1. Windows 非 WSL 环境，切勿强行跑 nvm-sh，会踩软链接 Bug。
2. 不要把 nvm 目录整体搬到 OneDrive/Dropbox，会导致 PATH 失效。
3. 同时装 nvm + 官方 pkg 会“打架”，卸载系统级 Node 要干净：
macOS sudo rm -rf /usr/local/lib/node_modules /usr/local/bin/node
4. 全局安装 CLI 工具后，切版本发现“命令找不到”—— 每个版本沙盒独立，记得重安。
5. 老项目 openssl 兼容报错，不是 nvm 锅，是 Node 17+ 默认 openssl3，降级或加 NODE_OPTIONS=–openssl-legacy-provider。

━━━━━━━━━━━━━━━
🗺️ 一张图速查命令表（建议收藏）
━━━━━━━━━━━━━━━

nvm list                → 查看已安装
nvm list available      → 查看官方线上版本
nvm install 18.18.2     → 安装指定版
nvm use 18.18.2         → 当前 shell 切换
nvm alias default 18    → 设置全局默认
nvm uninstall 14.21.3   → 卸载不留痕
nvm which 16            → 看该版本路径
nvm exec 14 node app.js → 临时跑单次命令

━━━━━━━━━━━━━━━
🎁 一键脚本大礼包（开箱即用）
━━━━━━━━━━━━━━━

# 1. 批量安装“前端开发四件套”
cat <<'EOF' > setup-node.sh
#!/usr/bin/env bash
set -e
versions=("16.20.2" "18.18.2" "20.9.0")
for v in "${versions[@]}"; do
  nvm install $v
  nvm use $v
  nvm install-latest-npm
  npm i -g yarn pnpm ts-node
done
nvm alias default 18
echo "✅ All done!"
EOF
chmod +x setup-node.sh
./setup-node.sh

━━━━━━━━━━━━━━━
📣 写在最后：让效率成为肌肉记忆
━━━━━━━━━━━━━━━
版本管理，是工程师“隐形”的时间杠杆。
花 10 分钟驯服 nvm，未来每个项目都能帮你省下一杯咖啡的调试时间。
日积硅步，十年就是一整块护城河。

如果本文帮到了你，去 GitHub 给 nvm 点个 ⭐ 吧！
也把这份速查表甩进同事群，别再让“版本问题”成为拖延的借口。

🚀 关于作者：
「前端真凶」公众号主理人，专注 CLI 与工程提效，每周拆解一个开发神器。
评论区告诉我：
“你因为 Node 版本被坑过最离谱的 bug 是什么？”

#nvm #NodeJS #开发效率 #工程化 #CLI艺术