VSCode本身不感知工作区Node版本，必须同时配置终端环境继承、shell初始化和launch.json中runtimeExecutable动态引用NVM_BIN，缺一不可；否则nvm use仅临时生效，F5调试、任务运行等仍用错版本。
VSCode 本身不感知工作区对应的 Node 版本，nvm use 只影响当前终端会话，F5 调试、任务运行、扩展（如 ESLint）仍可能用错版本——必须为每个工作区单独配置终端 + 调试器 + shell 初始化三者，缺一不可。
为什么工作区切换后 Node 版本“回退”了？
VSCode 启动时只加载一次环境变量快照，nvm use 不会广播给其他进程；新开工作区窗口或重开文件夹时，集成终端默认以 non-login shell 启动，跳过 ~/.zshrc 或 ~/.bash_profile，导致 nvm 根本没加载，$NVM_BIN 为空。
- 现象：
which nvm返回空，echo $NVM_BIN无输出，但系统自带node却能执行 - 根本原因：VSCode GUI 进程未继承 shell 初始化逻辑，
terminal.integrated.inheritEnv默认为false - 验证方式：新开终端后直接运行
nvm current，不是cd进项目再运行
工作区级终端环境必须靠 .vscode/settings.json 显式接管
不能依赖全局设置或手动在终端里 nvm use ——那只是临时会话，不固化到该工作区上下文。正确做法是在项目根目录的 .vscode/settings.json 中声明终端行为：
- 启用环境继承：
"terminal.integrated.inheritEnv": true - 指定 shell profile（macOS/Linux 示例）：
"terminal.integrated.defaultProfile.osx": "zsh" - 补全关键环境变量（避免依赖用户 shell 配置）：
"terminal.integrated.env.osx": { "NVM_DIR": "/Users/you/.nvm", "PATH": "/Users/you/.nvm/bin:${env:PATH}" } - 必须完全退出 VSCode（不只是关窗口）再重开，否则继承不生效
launch.json 里 runtimeExecutable 必须动态引用 NVM_BIN
调试器启动时完全不读终端 PATH，只认 launch.json 里写的路径。硬编码绝对路径（如 "runtimeExecutable": "/Users/xxx/.nvm/versions/node/v18.17.0/bin/node"）会导致跨机器失效；而留空或写错变量名，就会 fallback 到系统默认 node。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 正确写法：
"runtimeExecutable": "${env:NVM_BIN}/node" - 前提：终端里
echo $NVM_BIN有输出，且 VSCode 已继承该变量（见上一条） - 验证方式：在代码中加
console.log(process.version)，F5 启动后看输出是否匹配nvm current - 别漏掉逗号和引号闭合——JSON 语法错误会导致整个 launch 配置静默失效
想“自动切版本”？.nvmrc 文件本身没用，得配脚本驱动
.nvmrc 只是文本声明，VSCode 不读它，nvm 也不会在你打开工作区时自动触发 nvm use。所谓“自动”，本质是靠终端启动时执行脚本完成。
- 在项目根目录建
.vscode/activate.sh，内容为：nvm use || nvm install - 赋予执行权限：
chmod +x .vscode/activate.sh - 在
.vscode/settings.json中定义自定义 profile："args": ["-i", "-c", "source .vscode/activate.sh && exec bash"] -
-i确保加载~/.zshrc，exec bash替换当前 shell 进程，避免终端闪退
最易被忽略的是：VSCode 启动顺序。它先加载 GUI 进程，再拉起终端，最后才读 launch.json。任何一层断链（比如 inheritEnv 没开、NVM_BIN 展开为空、runtimeExecutable 路径拼错），都会让 Node 版本在某个环节悄悄降级。
