VSCode本身不管理依赖包，因它不安装、升级或锁定项目node_modules或全局npm包；问题源于系统Node升级后VSCode子系统未同步更新，或npm rebuild未对齐VSCode内置Node的napi版本（如1.90+需napi=9）。
为什么 VSCode 本身不管理你的依赖包
VSCode 不安装、不升级、也不锁定你项目里的 node_modules 或全局 npm 包。所谓“依赖包更新破坏兼容环境”，实际是两类错位：一是你手动升级了系统 Node.js（比如从 v18 升到 v20），但 VSCode 的终端/插件主机仍加载旧环境；二是你运行了 npm rebuild，却没对齐 --napi-build-version 和 VSCode 内置 Node 的 napi 版本（例如 VSCode 1.90+ 用的是 Node.js 22.4.0，process.versions.napi === '9'）。
终端里 node --version 还是旧的？重启不等于重载环境
VSCode 启动时会固化 shell 的 PATH 快照，nvm use 切换后主进程不会自动刷新。只关窗口没用，必须彻底退出进程：
- Windows：在任务管理器中结束所有
Code.exe进程（包括后台服务） - macOS：Dock 右键 VSCode → Quit（不是只关窗口），再从终端执行
code . - Linux / nvm 用户：执行
code --no-sandbox --disable-gpu启动可绕过部分环境缓存 - 验证是否生效：在 VSCode 终端运行
which node，输出应指向~/.nvm/versions/node/vxx.x.x/bin/node
插件报 Cannot find module './build/Release/xxx.node' 怎么办
这是原生模块 ABI 不匹配的铁证。不要盲目删 node_modules，先确认三件事：
- 查插件实际运行环境：
console.log(process.versions.napi)—— 必须等于 VSCode 当前内置 Node 的 napi 版本（1.90+ 是9） -
npm rebuild命令必须带全参数：npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0 - 清空插件目录下的
node_modules/.pnpm和out/，否则旧二进制会被优先加载
如何让插件永远不因依赖更新而崩掉
VSCode 插件有独立的 node_modules，它不复用你项目的依赖。所以即使你项目里装了 axios@1.7.0，插件若声明依赖 axios@1.6.0，就必须在插件源码根目录下单独 npm install。
- 打开插件源码目录（不是你的业务项目），运行
npm install - 检查
node_modules是否包含package.json中dependencies声明的所有包 - 打包前必须执行
vsce package，它不会自动装依赖，只打包已存在的node_modules - 调试时若报
module not found，检查launch.json的program字段是否指向正确入口（如${workspaceFolder}/out/extension.js）
最易被忽略的点：插件控制台打印的 process.version 是假象，process.versions.napi 才是加载原生模块的唯一通行证 —— 它不对，一切 rebuild 都白做。
