vscode终端中node -v显示旧版本是因为未加载shell配置导致nvm失效；需确认~/.zshrc或~/.bashrc含nvm初始化代码，且必须通过终端执行code .启动vscode，并完全退出后重开以继承环境变量。
VSCode终端里node -v还是旧版本？先确认nvm是否被加载
不是nvm没切对，而是VSCode根本没读你的shell配置。打开集成终端，执行nvm命令，如果报command not found，说明nvm初始化代码压根没生效。
检查~/.zshrc（macOS）或~/.bashrc（Linux）末尾是否有类似这段初始化代码：
export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
确认后，必须从终端启动VSCode：code .——这才能确保它加载当前shell的环境变量。直接双击图标启动，会绕过shell配置，$NVM_BIN为空，${env:NVM_BIN}/node展开失败。
- 改完配置后，务必完全退出VSCode（macOS右键Dock → Quit；Windows任务管理器结束所有
Code.exe）再重开 - 重启后，在终端运行
echo $NVM_BIN，应输出类似/Users/xxx/.nvm/versions/node/v18.20.4/bin - 别在
settings.json里手动写terminal.integrated.env.osx覆盖PATH，那会破坏nvm的路径链
launch.json里runtimeExecutable不生效？路径解析依赖环境继承
runtimeExecutable只在调试会话中生效，但它依赖${env:NVM_BIN}能正确展开。如果展开为空，调试器会 fallback 到PATH第一个node，通常是系统自带的老版本。
关键前提是：terminal.integrated.inheritEnv必须设为true，且VSCode是重开的。否则${env:NVM_BIN}永远为空字符串，"${env:NVM_BIN}/node"就变成"/node"，直接报Cannot resolve runtimeExecutable。
- 验证方式：在集成终端执行
which node，输出应为~/.nvm/versions/node/vxx.x.x/bin/node - launch.json中写法必须严格：
"runtimeExecutable": "${env:NVM_BIN}/node"（注意斜杠方向、引号闭合、无空格） - 不要硬编码绝对路径，比如
"runtimeExecutable": "/Users/xxx/.nvm/versions/node/v18.17.0/bin/node"——换机器就失效
插件报Cannot find module './build/Release/xxx.node'？不是Node版本问题，是napi_build_version错配
断点灰掉、原生模块加载失败，大概率不是你用的Node版本低，而是VSCode插件主机跑的是Electron内置Node（比如v22.4.0），它的process.versions.napi === 9，而你用系统Node（v20.x）执行npm rebuild生成的是napi=8的二进制。
重编译必须指定目标ABI：
npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0
而且得先清空缓存：
- 删掉插件目录下的
node_modules/.pnpm和out/ - 删掉
node_modules里对应原生模块的build/目录 - 确保
process.versions.napi在插件控制台里打印出来是9，不是8或7
多个项目要不同Node版本？别死磕nvm全局切换，用Dev Containers隔离
频繁nvm use不仅麻烦，还会让VSCode终端、调试器、插件主机三者状态不同步。真正稳的方式是每个项目配一个Dev Container。
在项目根目录建.devcontainer/devcontainer.json，指定镜像：
{
"image": "mcr.microsoft.com/devcontainers/node:18",
"features": {}
}
打开项目后点击左下角> → <code>Reopen in Container，整个开发环境（终端、调试器、扩展）都跑在容器内，和宿主机完全隔离。
- 容器内可自由
nvm install 16 && nvm use 16，不影响其他项目 - 无需操心
runtimeExecutable或NVM_BIN继承问题，环境变量天然干净 - 团队协作时，
.devcontainer目录提交到Git，新人拉下来一键复现环境
最常被忽略的其实是ABI兼容性——process.versions.napi必须和原生模块编译时声明的napi_build_version完全一致，差1都不行。版本号只是表象，napi才是真实门槛。
