VSCode调试Node.js必须同时配置终端环境和launch.json，否则F5仍用旧版本；需启用terminal.integrated.inheritEnv为true，并在launch.json中设"runtimeExecutable": "${env:NVM_BIN}/node"。
VSCode 本身不感知项目所需的 Node 版本，必须靠终端环境 + 调试器双路显式配置才能生效。只改一边，F5 调试或终端命令就会用错版本。
终端里 node -v 对了，但 F5 启动还是旧版本？
这是因为 VSCode 调试器（type: "node"）启动时只读取它启动那一刻的环境变量快照，完全不继承终端的 PATH 或 NVM_BIN。
- 必须在项目根目录的
.vscode/launch.json中加"runtimeExecutable": "${env:NVM_BIN}/node" - 前提：在集成终端里运行
echo $NVM_BIN确实有输出，否则说明 nvm 没加载成功 - 验证方式：在代码里写
console.log(process.version)，F5 启动后看输出是否匹配预期 - 别硬编码路径（如
"runtimeExecutable": "/Users/x/.nvm/versions/node/v18.19.0/bin/node"），换机器就失效
新开终端还是调用系统自带 node？
VSCode 默认以 non-login shell 启动终端，跳过 ~/.zshrc 或 ~/.bash_profile，导致 nvm 初始化逻辑（source ~/.nvm/nvm.sh）根本没执行。
- macOS/Linux：在 VSCode 设置中搜
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里有Import-Module "$env:USERPROFILE\.nvm\nvm.ps1"，且 VSCode 终端 profile 设为 PowerShell - 验证：新开终端后运行
which nvm和nvm current，两者都应有合理输出
想打开项目就自动切版本？别指望“静默切换”
.nvmrc 文件只是个声明，没人读它就等于不存在。VSCode 不原生支持自动解析 .nvmrc，nvm 本身也不会在你 cd 进目录时自动触发 nvm use。
- 最轻量做法：在项目根目录放
.nvmrc（内容如v16.20.2），每次打开项目后，在终端手动跑一次nvm use - 省事一点：装插件
vsc-nvm，它会在 VSCode 启动新终端时自动检测并执行nvm use；注意——已存在的终端需重启才生效 - Volta 用户注意：
.nvmrc写范围（如^18）无效，只能用具体版本或别名（lts），且必须先运行volta pin node@18.19.0生成.node-version
单项目沙盒：不碰系统、不依赖 nvm 的硬隔离方案
适合不想装 nvm、或多个项目版本冲突严重时。直接在项目级注入 PATH，只对当前工作区生效。
- 在项目根目录建
.vscode/settings.json，内容类似：
{
"terminal.integrated.env.windows": {
"PATH": "C:/dev/node-v16.20.2;${env:PATH}",
"NODE_PATH": "C:/dev/node-v16.20.2/node_modules"
}
}
PATH 必须把你的 Node 目录放在最前面，否则系统自带的 node.exe 仍会被优先调用真正麻烦的不是配置本身，而是 VSCode 启动时环境变量快照和终端 shell 加载时机的错位。多数人卡在「以为配了终端就够了」，结果调试器始终走不通——这是最容易被忽略的双路协同点。
