vscode终端node -v显示旧版本是因主进程启动时固化shell环境快照，nvm切换后未刷新path；需彻底重启进程或执行reload shell environment，并验证which node路径是否正确。
VSCode终端node -v还是旧版本？主进程环境快照没刷新
VSCode 启动时固化了 shell 的 PATH 快照，nvm 或 fnm 切换后，已运行的主进程不会自动感知。你看到的 node -v 是“启动那一刻”的值，不是当前 shell 的真实状态。
验证方式：在 VSCode 终端里运行 which node（macOS/Linux）或 where node（Windows），输出路径若不是你 nvm use v20.15.0 后该指向的位置，就确认是快照问题。
- Windows：任务管理器中结束所有
Code.exe进程（不只是关窗口），再重新启动 - macOS：Dock 右键 VSCode → Quit（不是关闭窗口），然后从终端执行
code .启动 - nvm-windows 用户：每次
nvm use后，必须在 VSCode 中按Ctrl+Shift+P执行Terminal: Reload Shell Environment
断点灰掉、Cannot find module './build/Release/xxx.node'？ABI 版本错配
VSCode 1.90+ 内置 Node.js 22.4.0，process.versions.napi 固定为 9；而你用系统 Node v20.x（napi=8）跑的 npm rebuild，生成的 .node 文件 ABI 不兼容，加载时被静默拒绝——不是路径错，也不是文件丢，是校验失败。
打开 VSCode 开发者工具（Help → Toggle Developer Tools），在 Console 里执行：process.versions.napi —— 如果返回 "9"，但插件仍报错，基本就是这个原因。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 重编译必须用 VSCode 自带的 Node.js 运行时，不能用系统
node - 参数必须完整：
--napi-build-version=9 --runtime=electron --target=34.0.0 - 务必先清空插件目录下的
node_modules/.pnpm和out/，否则旧缓存优先加载
多根工作区下 npm run dev 报 command not found？PATH 不随焦点切换
VSCode 集成终端默认继承启动时的 shell PATH，不随你在资源管理器中点击哪个子文件夹而动态更新 node_modules/.bin 路径。你在 A 项目里右键打开终端，PATH 就是 A 的；切到 B 项目编辑，终端仍是 A 的上下文。
- 右键资源管理器中某个子文件夹 →
Open in Integrated Terminal，新终端会自动cd进该路径并加载其node_modules/.bin - 或用命令面板执行
Terminal: Create New Terminal in Active Workspace Folder - 脚本调用尽量显式用
npx，比如npx vite而非直接vite，避免 PATH 查找歧义
调试器 runtimeExecutable 不生效？它只管主进程，不管插件主机
runtimeExecutable 只控制调试会话的主进程（即你 program 指向的那个 JS 文件运行时用的 Node），完全不影响扩展主机（Extension Host）和任何含原生模块的插件。断点灰掉、智能提示失效、require('./xxx.node') 报错，都不是它能解决的。
如果你写了 "runtimeExecutable": "${env:NVM_BIN}/node" 却发现没效果，大概率是因为：
— NVM_BIN 环境变量根本没加载进 VSCode 主进程（见第一个副标题）
— 或你误以为它能改变插件运行时环境（它不能）
- 调试器真正生效的前提是：VSCode 主进程已加载正确 PATH，且
process.version在 Debug Console 里和终端node -v一致 - 硬编码路径（如
"/Users/xxx/.nvm/versions/node/v20.15.0/bin/node"）跨机器即失效，不可靠 - 复杂项目建议用 Dev Containers：每个容器自带独立 Node、npm、ABI 环境，彻底隔离版本冲突
最常被忽略的是：你以为改了 launch.json 就万事大吉，其实 VSCode 插件主机、语言服务、调试器、终端，四者环境完全解耦。修一个，不等于其他三个也对齐。尤其是 process.versions.napi 这个值，它藏得深、影响广、报错静默，必须手动验证，不能只信 node -v 输出。
