VSCode 不管理 Node.js 版本，依赖 shell 环境中的 nvm；需确保终端正确加载 nvm、.nvmrc 绑定版本、runtimeVersion 仅限调试器生效，且各模块环境需分项验证。
VSCode 本身不管理 Node.js 版本，它只读取并使用你 shell 环境中已激活的 Node 版本。所以“在 VSCode 中用 nvm 管理 Node”这件事，本质是让 VSCode 的终端、调试器、任务、扩展全部看到同一个 nvm use 后的环境——而不是靠 VSCode 设置去“切换版本”。
终端里 node -v 和调试器里不一样？先查 nvm 是否加载成功
这是最常被忽略的第一步。VSCode 集成终端启动时，会读取你的 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile），但仅当该文件里明确加载了 nvm 才生效。
- 在 VSCode 终端里运行
which nvm：如果返回空，说明 nvm 根本没加载，nvm use命令都不可用 - 检查你的 shell 配置文件末尾是否有类似这段代码（路径需与你实际安装位置一致）：
export NVM_DIR="$HOME/.nvm"<br>[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
- macOS 用户注意：用
code --new-window从终端启动 VSCode，才能确保它继承当前 shell 的完整环境；直接点击图标启动可能绕过 shell 初始化
launch.json 中的 runtimeVersion 只影响调试器进程
这个字段看起来像“全局切换 Node 版本”，但它只对 VSCode 自带的 Node 调试器（type: "node"）起作用，且底层调用的是 nvm exec 。
- 如果
nvm不在$PATH，或目标版本未安装（比如写了"runtimeVersion": "18.18.2"但还没执行nvm install 18.18.2），调试直接失败，报错Cannot find module 'nvm' - 它对终端、
tasks.json、ESLint、TypeScript Server 等完全无效——这些组件仍按终端当前环境走 - 不要把它当成“统一版本”的方案，它只是调试器的兜底机制；真正统一靠的是
nvm use+.nvmrc
用 .nvmrc 实现项目级自动版本绑定
这是目前最轻量、兼容性最好、CI/CD 也认的方式。VSCode 不直接解析 .nvmrc，但你可以让它成为工作流的一部分。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 在项目根目录新建
.nvmrc，内容只有一行：18.18.2
- 打开 VSCode 集成终端后，手动执行一次
nvm use（它会自动读.nvmrc）；之后node -v、which node、echo $PATH应全部指向~/.nvm/versions/node/v18.18.2/bin/node - 想自动化？在
.vscode/tasks.json里加一个 shell 类型任务：{<br> "label": "nvm use",<br> "type": "shell",<br> "command": "nvm use",<br> "group": "build",<br> "presentation": { "echo": true, "reveal": "always" }<br>}然后设为启动任务（"isBackground": true可选）
扩展和 ESLint 报“找不到 node”？别硬配 node.execPath
很多教程建议在 .vscode/settings.json 里写死 "node.execPath"，但这容易失效：路径随 nvm 安装位置、用户名、系统而变，且无法响应 nvm use 的动态切换。
- 优先确保终端环境正确（前面三步做完后，
which node有输出且路径合理） - 重启 VSCode 窗口（不是只关终端），让所有扩展重新读取环境变量
- 若仍有问题（比如某些老旧扩展顽固读系统 PATH），再考虑显式指定：
"node.execPath": "~/.nvm/versions/node/v18.18.2/bin/node"
但记得用绝对路径，且每次换版本都要手动改 - Windows 用户注意：
nvm-windows的路径格式不同，通常是C:\Users\xxx\AppData\Roaming\nvm\v18.18.2\node.exe，不能直接套用 macOS/Linux 写法
真正麻烦的从来不是 nvm 本身，而是 VSCode 不同模块读环境的方式不一致：终端靠 shell 初始化，调试器靠 runtimeVersion 或 nvm exec，任务靠 tasks.json 显式调用，扩展则依赖启动时捕获的父进程环境。一旦某个环节掉链子，版本就错位——所以验证必须分项做，不能只看 node -v 一行输出。
