Node 多版本切换总出错？nvm 使用与路径冲突定位

一句话承诺：用排查表与命令清单，快速解决 nvm 切换版本后“命令仍旧旧版本”的路径冲突。

排查表

命令清单（macOS/Linux）

# 查看Node调用路径
which node
# 查看所有版本
nvm list
# 切换版本
nvm use v18.17.1
# 确认版本
node -v
# 全局包位置
npm root -g

Windows（nvm-windows）

nvm list
nvm use 18.17.1
where.exe node
npm root -g
# 如果仍冲突，检查系统环境变量PATH的顺序：
# 把 nvm 的 node 路径放在前面，移除旧的 node 安装目录。

少量解释

• nvm 切换版本后，旧 PATH 中残留的 node 安装目录可能抢先被命中。
• 不同版本的全局包路径不同，切换版本后需要重新安装。
• 统一使用 shell 初始化脚本，保证每次打开终端都加载 nvm。

常见坑与替代法

• 坑：shell未加载nvm脚本。替代：在 .bashrc/.zshrc 加入 nvm 初始化。
• 坑：Windows PATH 混乱。替代：用 nvm-windows 自带的路径管理，移除旧 node。
• 坑：全局包混用。替代：按版本分开安装或使用 pnpm 管理。

下一篇预告

API 错误码不统一？六类错误响应的落地模板（JSON示例+表格）。