VSCode插件报“Cannot find module”是因扩展主机进程使用内置Node.js且隔离插件自身node_modules，需在插件目录安装依赖、确认package.json声明、清理pnpm缓存、重启VSCode全进程；.node文件失败则多因ABI版本不匹配（如VSCode 1.90+用napi=9而模块为napi=8），须用VSCode内置Node重编译。
VSCode插件报“Cannot find module”但本地node -v正常
这不是你系统Node没装好，而是插件运行在VSCode扩展主机进程里，它用的是VSCode内置Node.js，不是你终端里的那个。插件自身的node_modules必须在插件源码目录下安装，和你的业务项目完全隔离。
- 打开插件开发目录（比如
my-extension/），确认里面有没有node_modules；没有就进该目录执行npm install或pnpm install - 检查
package.json的dependencies是否列出了报错模块（如"vscode-languageclient"），漏写会导致require失败 - 如果用了
pnpm，确保没误删node_modules/.pnpm缓存目录——旧缓存可能让TS Server加载了错误版本的类型定义 - 改完后必须重启VSCode全进程（不只是Reload Window），否则扩展主机仍跑着旧环境
require('./xxx.node')静默失败，控制台只显示“Cannot find module”
这几乎肯定是ABI版本不匹配：VSCode 1.90+内置Node.js 22.4.0（napi_build_version=9），而你预编译的.node文件大概率是用Node.js 20.x（napi=8）构建的，VSCode直接拒绝加载，连错误堆栈都不抛。
- 在VSCode开发者工具Console中执行
process.versions.napi，输出"9"即确认是ABI问题 - 别用
npm rebuild——它默认调系统Node，生成的仍是napi=8模块；必须显式调VSCode自带的Node可执行文件来重编译 - macOS示例命令：
~/.vscode/Code.app/Contents/Frameworks/Code\ Helper\ \(Renderer\).app/Contents/MacOS/Code\ Helper\ \(Renderer\) --type=extensionHost node /usr/bin/npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0 - 重编译后删掉插件目录下的
out/和node_modules/.pnpm，避免缓存干扰
插件安装.vsix后仍报依赖缺失或启动失败
.vsix不是zip解压就能用，VSCode会校验签名和兼容性字段，尤其1.85+之后更严格。
- 用ZIP工具打开.vsix，检查根目录
package.json里是否有engines.vscode，值是否匹配你当前VSCode版本（如"^1.90.0"） - 确认
package.json的main字段指向的入口文件真实存在，且路径大小写与磁盘一致（Windows上容易忽略这点） - 如果插件依赖Electron特定API，需检查
engines.node是否和VSCode内置Node兼容（比如写">=18.0.0"但VSCode实际是v22.4.0，没问题；若写"就会被拒） - 签名验证失败时，VSCode不会明确提示，只会静默禁用插件——打开Help → Toggle Developer Tools → Console，看有没有
Signature verification failed日志
远程开发（SSH/WSL）下插件行为异常
远程模式下，插件默认仍走本地VSCode内置Node，除非你明确配置了远程扩展主机。很多用户以为连上SSH就自动切环境，其实不是。
- 右下角必须看到
SSH:xxx或WSL:Ubuntu标识，没看到说明根本没走远程，插件仍在本地运行 - 确保Remote Extension Pack已安装，且插件本身声明支持远程（
package.json含"extensionKind": ["workspace", "ui"]或["workspace"]） - 插件若需调用
node命令（比如spawn子进程），必须在远程机器上装好对应版本，并确认$PATH包含其路径；本地terminal.integrated.env.*设置对远程插件无效 - 调试插件时，
launch.json的runtimeExecutable要指向远程node路径（如/home/user/.nvm/versions/node/v20.15.0/bin/node），不能留空或用默认值
node -v判断全局状态。 
