VSCode调试Node.js必须同时配置终端和调试器路径，仅配其一会导致版本错乱；需在launch.json中设runtimeExecutable，并确保终端正确加载nvm或Volta环境。
VSCode 本身不自动识别项目所需的 Node 版本，必须手动配齐终端环境和调试器两路路径，缺一不可。只改其中一边，必然出现终端用 v18、F5 调试却跑在 v16 的错乱现象。
终端里 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"不可移植，换机器或重装 nvm 就失效
新开终端仍调用系统自带 node？
VSCode 默认以 non-login shell 启动终端，跳过 ~/.zshrc 或 ~/.bash_profile，导致 source ~/.nvm/nvm.sh 这类初始化逻辑压根没执行。
- macOS/Linux：在 VSCode 设置中搜
terminal.integrated.inheritEnv，设为true，然后完全退出 VSCode（不只是关窗口）再重开 - 或者直接编辑
.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"，且终端 profile 设为 PowerShell - 验证：新开终端后运行
which nvm和nvm current，两者都应有合理输出
如何让每个工作区自动加载对应 Node 版本？
VSCode 不原生读 .nvmrc，也不会自动执行 nvm use —— 这个文件只是声明，没人读它就等于不存在。
- 最轻量做法：项目根目录放
.nvmrc（内容如v16.20.2），每次打开项目后，在终端手动运行nvm use - 省事一点：装插件
vsc-nvm，它会在新终端启动时自动检测并执行nvm use（注意：已存在的终端需重启才生效） - Volta 用户注意：
.node-version必须由volta pin node@18.19.0生成，.nvmrc里的范围写法（如^18）Volta 不认
真正容易被忽略的是：终端和调试器这两条路径必须各自独立验证，不能靠“终端对了就以为全对”。尤其在多项目切换时，NVM_BIN 可能残留上一个项目的值，而 launch.json 又没及时更新，结果就是静默错配。
