VSCode 配合 NVM 实现 Node 版本多项目并发运行隔离

很多人以为在终端里用 nvm 切好 Node 版本就万事大吉了，结果回到 VSCode 调试器一按 F5，跑的还是系统自带的老版本。这个问题坑了不少人——不是 nvm 不好用，而是 VSCode 的集成终端和调试器压根没走同一条路。今天就把这个疙瘩彻底拆开来讲。

VSCode 终端不识别 nvm 切换的 Node 版本？

根本原因其实很简单：VSCode 集成终端默认不是 login shell，意味着 ~/.zshrc 或 ~/.bash_profile 里那些初始化逻辑——比如 source ~/.nvm/nvm.sh——压根没被触发。终端启动时 nvm 根本不在环境里，自然认不出你切的版本。

解决办法只有两条路可走：

• 在 VSCode 设置里搜索 terminal.integrated.inheritEnv，把它设为 true，然后完全退出 VSCode（注意，光关窗口不行，得彻底关掉进程）再重开。
• 或者在 settings.json 里手动补全环境变量："terminal.integrated.env.zsh": { "NVM_DIR": "/Users/你/.nvm", "PATH": "/Users/你/.nvm/bin:${env:PATH}" }

怎么验证？新开一个终端，运行 which nvm 和 nvm current，这两条命令都应该有合理输出。如果 echo $NVM_BIN 是空的，说明 nvm 根本没加载——后面所有配置都是白搭。

调试器（F5）仍用旧版 Node？

终端的问题解决了，但调试器又是另一回事。VSCode 调试器（type: "node"）启动时只读取启动那一刻的环境快照，完全不继承终端的 PATH 或 NVM_BIN。所以终端里 node -v 显示的是切换后的版本，F5 却依然用老版本——这几乎是必然的。

解决方案是在项目根目录的 .vscode/launch.json 中显式指定路径：

{
  "configurations": [{
    "type": "node",
    "request": "launch",
    "runtimeExecutable": "${env:NVM_BIN}/node",
    "program": "${file}"
  }]
}

注意：${env:NVM_BIN} 必须真实存在——也就是说，上一步终端里 nvm 必须已经成功加载。千万别用硬编码路径，比如 /Users/x/.nvm/versions/node/v18.19.0/bin/node，换台机器就失效了。

打开项目就想自动切 Node 版本？别信“自动”

.nvmrc 文件就是个声明，没人读它，它就等于不存在。VSCode 不会原生解析它，nvm 本身也不会自动触发 nvm use。指望它自动切版本？不存在的。

可行方案只有这几个：

• 手动最稳：项目根目录放 .nvmrc（内容比如 v16.20.2），每次打开后在终端执行一次 nvm use。
• 插件辅助：安装 vsc-nvm，它会在新终端启动时自动检测并执行 nvm use（已存在的终端需要重启才生效）。
• Volta 用户注意：Volta 不支持 .nvmrc 写范围（比如 ^18），只能用具体版本或别名（lts），而且必须先运行 volta pin node@18.19.0。

多工作区同时打开不同 Node 版本？

VSCode 的多工作区（Multi-root Workspace）模式下，.vscode/launch.json 是工作区级别的，但终端环境仍然是全局共享的——一个终端无法同时属于两个 Node 版本。这点很容易被忽视。

正确的做法是：

• 每个子文件夹独立打开一个窗口（而不是加入同一个工作区），各自配好 .nvmrc 和 launch.json。
• 或者使用 Remote-SSH + Docker 容器，在远程隔离环境中运行不同 Node 版本，本地 VSCode 只负责编辑和转发。
• 避免在同一个集成终端里混跑多个项目的命令——npm start 和 yarn dev 可能因为 Node 版本错位直接报错。

真正容易被忽略的是：调试器和终端的环境变量传递是两条独立通路，漏配任何一条，都会导致「一半对一半错」。没有银弹，只有双路显式配置。