VSCode多工作区Node环境独立配置-VSCode-PHP中文网

VSCode多工作区无法自动隔离Node.js版本，必须通过工作区级.vscode/settings.json、项目专属启动脚本（如activate.sh）与nvm/fnm三者联动实现；仅设置terminal.integrated.env.*环境变量无效，因其只声明不执行，须调用nvm use或fnm use才真正切换版本。

vscode多工作区node环境独立配置

VSCode 多工作区无法自动隔离 Node.js 版本，不是靠改设置就能解决的——必须用工作区级 .vscode/settings.json + 启动脚本 + nvm（或 fnm）三者联动，否则新开终端仍会沿用上一个项目的 node 版本。

为什么 `terminal.integrated.env.linux` 单独设 NODE_VERSION 没用

环境变量如 NODE_VERSION 只是“声明”，不触发版本切换；nvm use 或 fnm use 才是真正加载对应 node 二进制的动作。只写 "NODE_VERSION": "18.17.0" 到 env 里，终端启动后执行 node -v 依然显示旧版本。

terminal.integrated.env.* 仅注入变量，不执行命令，也不修改 PATH
即使你把 nvm 的 sh 脚本路径加进 PATH，没调用 nvm use 就不会切版本
验证方式：新开终端后，先运行 nvm current，再运行 node -v，两者必须一致才说明生效

怎么让每个工作区终端自动 `nvm use`

核心是让终端启动时执行项目专属的 shell 初始化逻辑，而不是依赖全局 ~/.bashrc 或 ~/.zshrc —— 那些文件对所有项目一视同仁，没法区分工作区。

在项目根目录下创建 .vscode/activate.sh，内容为：

nvm use 18.17.0 > /dev/null 2>&1 || echo "nvm use failed"; source ~/.nvm/nvm.sh > /dev/null 2>&1

给脚本加执行权限：chmod +x .vscode/activate.sh

在项目级 .vscode/settings.json 中配置 profile：

"terminal.integrated.profiles.linux": {
  "Project Node 18": {
    "path": "bash",
    "args": ["-i", "-c", "source .vscode/activate.sh && exec bash"]
  }
},
"terminal.integrated.defaultProfile.linux": "Project Node 18"

-i 确保能读取 ~/.bashrc（含 nvm 加载逻辑），exec bash 替换当前进程，避免退出后终端关闭

`launch.json` 调试时仍用错 Node 版本？检查这三点

VSCode 调试器默认用系统 PATH 里的 node，和终端是否切了版本无关。调试失败常因 node 运行时和终端看到的不是同一个。

用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

确认 launch.json 中没硬编码 runtimeExecutable；留空则走 PATH
在调试前，先在 VSCode 内置终端里运行 which node 和 node -v，记下路径和版本
如果调试报 Cannot find runtime 'node' 或版本不符，说明调试器没继承终端的 PATH —— 此时需在 launch.json 显式指定：
```
"runtimeExecutable": "/home/user/.nvm/versions/node/v18.17.0/bin/node"
```
更稳妥的做法：把 nvm use 逻辑也塞进 preLaunchTask，用 tasks.json 启动前重置环境

Windows 用户注意：`nvm-windows` 不支持工作区级自动切换

nvm-windows 是 cmd/powershell 工具，不兼容 bash/zsh 的 source 机制，也无法被 VSCode 终端 profile 的 args 正确调用。它只能手动执行 nvm use，不能静默加载。

Windows 下推荐改用 fnm（Fast Node Manager），它是 Rust 写的跨平台工具，支持 fnm use --install 且能被 shell 脚本直接调用
若坚持用 nvm-windows，只能靠 PowerShell profile 脚本 + Set-Location 监听目录变化来模拟，但不可靠、易出竞态
验证方式：在 Windows 终端里运行 where node，输出路径必须和 nvm list 当前选中版本一致，否则调试必挂

真正起作用的从来不是某一个配置项，而是 .vscode/settings.json 定义行为、.vscode/activate.sh 执行动作、nvm/fnm 提供能力，三者缺一不可。漏掉任意一环，Node 版本就会“漂移”。