VSCode不自动检测Node.js版本，需通过.nvmrc文件、正确加载nvm的shell环境及launch.json中配置runtimeExecutable或runtimeVersion三者协同实现版本统一。
VSCode 不会自动检测 Node.js 版本，所谓“自动检测”其实是你配置的环境线索被终端或调试器被动响应的结果——没配对，node -v 和 process.version 就可能不一致。
为什么终端显示 v18 但调试器跑在 v16？
这是最常发生的错位现象，根源在于 VSCode 启动时加载的 shell 环境和调试器启动时读取的环境变量不一致：
-
terminal.integrated.inheritEnv默认为true，但若 VSCode 是从 Dock 或开始菜单启动，它可能根本没加载你的~/.zshrc或~/.bash_profile，导致nvm命令不可用、NVM_BIN为空 -
launch.json中的runtimeExecutable若写成"${env:NVM_BIN}/node"，而NVM_BIN展开失败，就会 fallback 到系统默认node - 插件如
vsc-nvm只在新开终端时触发nvm use，不影响已运行的调试会话或任务（tasks.json）
.nvmrc 文件必须怎么写才生效？
.nvmrc 不是配置文件，而是 nvm 的指令输入源——格式错误、位置不对、或没被 nvm 读到，就等于没写：
- 必须放在项目根目录（与
package.json同级），不能嵌套在子文件夹里 - 内容只能是纯版本号，比如
18.19.0或lts/hydrogen；v18.19.0、^18、>=18全部无效 -
nvm use命令是否成功，要靠which node和echo $PATH验证，不能只看node -v - Windows 用户若用 PowerShell，需确认
$PROFILE已加载nvm.ps1，否则nvm命令根本不存在
launch.json 怎么配才能让调试器用对 Node 版本？
调试器不认 package.json 里的 engines.node，也不自动读 .nvmrc，必须显式指定执行路径或版本：
- 推荐方式：用
runtimeExecutable指向 nvm 管理的二进制，例如"${env:NVM_BIN}/node"—— 但前提是NVM_BIN在 VSCode 启动时已注入环境 - 替代方式：用
runtimeVersion字段，例如"runtimeVersion": "18.19.0"，VSCode 会调用nvm exec 18.19.0 node；如果nvm不在$PATH，直接报错Cannot find module 'nvm' - 注意：
runtimeVersion对npm run dev类脚本完全无效，它只控制 debugger 进程本身 - 验证方法：在断点处打印
process.version，而不是依赖终端输出
别信“打开即切换”，真正起作用的是这三件事
所谓“自动识别”，本质是把人工操作封装进初始化流程。漏掉任何一环，都会导致版本错乱：
- 项目根目录存在格式正确的
.nvmrc - VSCode 集成终端能执行
nvm use（即 shell 初始化文件已加载 nvm，且terminal.integrated.inheritEnv为true） -
launch.json显式声明runtimeExecutable或runtimeVersion，且对应工具链可用
最容易被忽略的，是 VSCode 启动方式——从终端执行 code --new-window . 才能确保完整继承 shell 环境；从图标启动时，NVM_BIN 往往为空，${env:NVM_BIN} 展开失败，调试器就静默 fallback 到系统默认 Node。
