VSCode调试器默认不继承终端环境变量，需在settings.json中启用terminal.integrated.inheritEnv为true，并在launch.json中配置"runtimeExecutable": "${env:NVM_BIN}/node"以确保使用nvm切换后的Node版本。
nvm 切换了 Node 版本，但 VSCode 调试器仍用旧版本——根本不是 nvm 没生效，而是调试器压根没读你的 shell 环境。
为什么 node -v 在终端里是对的，但按 F5 调试却报错或跑错版本？
VSCode 的调试器（type: "node"）默认不继承集成终端的环境变量，它启动时直接查 PATH，而这个 PATH 是 VSCode 启动那一刻加载的，和你在终端里执行 nvm use 18.17.0 无关。哪怕你关掉终端重开、再 nvm use，只要没重启 VSCode 或没刷新调试器的运行上下文，它就继续用旧的 node 路径。
常见现象：
-
which node返回~/.nvm/versions/node/v18.17.0/bin/node，但 F5 启动后process.version打印的是v16.20.2 - 调试器报错
Cannot find module 'node:fs'（Node.js 16 不支持node:协议前缀，说明实际在跑旧版） -
launch.json里没配runtimeExecutable，它就去 PATH 里第一个找到的node，通常是系统自带或旧 nvm alias
runtimeExecutable 必须显式指定，且路径要动态可靠
硬编码绝对路径（如 "runtimeExecutable": "/Users/xxx/.nvm/versions/node/v18.17.0/bin/node"）看似能解决问题，但项目一换人、一换机器就挂。更稳的方式是利用环境变量间接指向：
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
-
nvm激活后会把当前版本的 bin 目录加到$NVM_BIN，这个变量在终端里可用，VSCode 的launch.json也认${env:NVM_BIN} - 正确写法：
"runtimeExecutable": "${env:NVM_BIN}/node" - 但前提是：VSCode 启动时得加载了
nvm，否则${env:NVM_BIN}展开为空，调试器直接报Cannot resolve runtimeExecutable - 验证方式：在集成终端里运行
echo $NVM_BIN，确认有输出；再检查launch.json配置是否拼写正确（大小写、斜杠方向、引号闭合）
VSCode 启动时没加载 nvm？优先开 terminal.integrated.inheritEnv
这是最常被忽略的一环。VSCode 默认不继承系统 shell 的环境，所以即使你 ~/.zshrc 里写了 export NVM_DIR... 和 source ~/.nvm/nvm.sh，VSCode GUI 进程也看不到 nvm 命令。
- 打开 VSCode 设置（
Cmd+,），搜terminal.integrated.inheritEnv，把它设为true - 改完必须完全退出 VSCode（不只是关窗口）再重开，否则继承无效
- 重启后，在集成终端里运行
which nvm，应返回~/.nvm/nvm.sh或类似路径；再运行nvm current看是否显示预期版本 - 如果仍不行，检查 shell 类型：macOS 默认是 zsh，设置项名是
terminal.integrated.env.zsh，别误配成bash的
.nvmrc 文件不会自动触发调试器切换
很多人以为放个 .nvmrc（内容为 18.17.0）进项目根目录，VSCode 就会“感知”并自动切版本——其实不会。.nvmrc 只对当前 shell 生效，靠你在终端里手动敲 nvm use 或启用 nvm 的 auto-use 功能（nvm use 自动触发）才起作用。VSCode 的调试器、ESLint、TypeScript Server 等所有后台进程，都不走这个逻辑。
- 想让项目开箱即用，推荐组合：
.nvmrc+terminal.integrated.inheritEnv: true+launch.json里用${env:NVM_BIN}/node - 不要依赖插件（如
vsc-nvm）自动执行nvm use：它只影响终端，不影响调试器，还可能和你的 shell 初始化冲突 - 如果项目必须强约束 Node 版本，可在
package.json加"engines": {"node": ">=18.17.0"}，配合npm install时校验（需开启engine-strict）
真正卡住人的从来不是「怎么切」，而是「切了之后谁在用、谁没用、谁缓存了旧值」。每次改完配置，务必关掉所有集成终端、重启 VSCode、再验证 which node 和 process.version 是否一致——少这一步，90% 的「版本不生效」问题都会白调半天。
