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

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 —— 那些文件对所有项目一视同仁，没法区分工作区。

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

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

下载

• 在项目根目录下创建 .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 运行时和终端看到的不是同一个。

• 确认 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 版本就会“漂移”。