VSCode不自动切换Node环境，必须终端与调试器双路协同配置：终端需启用terminal.integrated.inheritEnv并加载nvm，调试器须在launch.json中设"runtimeExecutable": "${env:NVM_BIN}/node"，缺一不可。
VSCode 本身不支持“切换 Node 环境”这个动作，所谓切换，其实是终端和调试器两套独立配置分别生效的结果。只配一半，必然出错。
终端里 node -v 对了，但 F5 调试还是旧版本？
这是最常被误判的问题：你以为终端切好了，调试器就自动跟上——其实完全不继承。
- VSCode 调试器（
type: "node"）启动时只读取自身进程启动那一刻的环境快照，PATH和NVM_BIN都不会从终端同步 - 必须在项目根目录的
.vscode/launch.json中显式写入："runtimeExecutable": "${env:NVM_BIN}/node" - 前提是
$NVM_BIN真的存在：在集成终端里运行echo $NVM_BIN，有输出才说明 nvm 已加载成功 - 硬编码路径如
"runtimeExecutable": "/Users/x/.nvm/versions/node/v18.19.0/bin/node"在换机器或重装 nvm 后立即失效
新开终端还是用系统自带 node？检查 shell 初始化是否被跳过
VSCode 集成终端默认不是 login shell，~/.zshrc 或 ~/.bash_profile 里的 source ~/.nvm/nvm.sh 根本不会执行。
- macOS/Linux：在设置中搜
terminal.integrated.inheritEnv，设为true，然后完全退出 VSCode（关窗口不算）再重开 - 更稳妥的做法是直接编辑
settings.json，补全环境变量："terminal.integrated.env.zsh": { "NVM_DIR": "/Users/you/.nvm", "PATH": "/Users/you/.nvm/bin:${env:PATH}" } - Windows PowerShell 用户需确认
$PROFILE中已导入nvm.ps1，且终端 profile 明确设为 PowerShell - 验证方式：新开终端后运行
which nvm和nvm current，两者都应返回合理值
多个项目同时打开，怎么避免 Node 版本串？
全局设置或 shell profile 无法隔离项目级 Node 版本——它们共享同一套终端初始化逻辑。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 靠工作区级配置：每个项目根目录下放独立的
.vscode/settings.json和.vscode/launch.json -
.nvmrc文件只是个声明，VSCode 不读它；nvm 本身也不自动执行nvm use，得靠人或插件触发 - 轻量做法：项目根目录放
.nvmrc（内容如v16.20.2），每次打开项目后手动跑一次nvm use - 省事做法：装插件
vsc-nvm，它会在新终端启动时自动检测并执行nvm use（注意：已有终端不生效，需重启）
compound 启动不是环境切换，别指望它解决版本问题
compound 是组合启动，不是环境切换。它把多个已定义好的 configurations 一起触发，所有环境细节都在子配置里定义。
-
compound本身不带env、envFile、runtimeExecutable等字段，它只是个“一键触发器” - 如果前后端要用不同 Node 版本，必须分别在各自的子配置里各自写好
"runtimeExecutable": "${env:NVM_BIN}/node" -
compound不保证启动顺序，前端依赖后端 ready 的场景，得靠preLaunchTask或外部工具（如concurrently）控制
真正麻烦的从来不是配置本身，而是 VSCode 启动时没加载 nvm 导致 ${env:NVM_BIN} 展开为空——这个空值不会报错，只会静默 fallback 到系统默认 node，而你很难第一时间意识到是这里出了问题。
