“not compatible with code”错误主因是插件engines.vscode版本不匹配，需比对code --version主版本号（如1.85.2→1.85）与.vsix中package.json的"engines": {"vscode": "^1.85.0"}字段，并确认架构一致。
code --install-extension 报 “not compatible with Code” 怎么快速定位
这个错误几乎全是 engines.vscode 版本不匹配导致的，和网络无关。VSCode 安装时会严格比对 .vsix 内 extension/package.json 中的 "engines": {"vscode": "^1.85.0"} 字段与本地 code --version 输出。
实操步骤：
- 运行
code --version，取第一段（如1.85.2→1.85） - 用
unzip -p your-plugin.vsix extension/package.json | grep engines（Linux/macOS）或 7-Zip 打开查看该字段 - 确保本地版本 ≥ 插件要求的最低版本（
^1.85.0表示 ≥ 1.85.0） - Help → About 里确认架构（x64 / arm64），ARM Mac 上装 x64 构建的插件不会报错，但语言服务器可能无法加载
拖拽安装没反应？先确认 VSCode 是否满足三个硬条件
VSCode 只在特定状态下响应拖拽：.vsix 文件必须拖进已加载工作区的主编辑区域（即你写代码的白底窗口），不是侧边栏、设置页或空白启动页。
常见静默失败原因：
- VSCode 窗口没获得系统焦点（任务栏图标未高亮）
- 处于全屏模式或远程桌面（如 RDP/TeamViewer 会拦截拖放事件）
- 拖的是解压后的文件夹或重命名过的
.zip，不是原始.vsix包（可用unzip -l xxx.vsix检查顶层是否为extension/目录）
插件列表显示“已安装”，但依赖分析不生效
这是离线环境最典型的假成功现象——安装通过了，但语言服务器或 CLI 工具没拉下来。像 ms-python.python、esbenp.prettier-vscode 这类插件，首次打开 .py 或 .js 文件时才会自动下载 pyright、prettier 等二进制依赖，默认走外网。
离线时状态栏卡在 Downloading… 或输出面板报 Failed to fetch。
解决办法不是重装 .vsix，而是提前在有网机器上：
- 打开对应文件类型（如一个
.py文件）→ 等状态栏变绿（表示 LSP 已就绪） - 再把整个扩展目录（如
%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0）完整拷到内网机器 - 不能只拷
.vsix文件，也不能只拷node_modules子目录——必须是解压后带package.json和out/或dist/的完整文件夹 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
批量部署时怎么不漏掉隐式依赖
团队统一环境不是靠人肉下载几个热门插件就能搞定的。装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化直接失效——这种坑没法靠“推荐列表”避开。
最稳方式：
- 在已配好的联网机器上导出完整列表：
code --list-extensions > extensions.txt - 逐行用
vsce download下载对应.vsix：vsce download ms-python.python@2024.6.0 - 真实依赖藏在
.vsix解压后的package.json的extensionDependencies字段里，不是插件页面写的“Recommended” - 批量安装后，务必重启 VSCode，再执行
Developer: Show Running Extensions查真实加载状态；很多插件（如ms-python.python）强依赖ms-python.pylance，没它就只是个空壳
真正难的从来不是“怎么装”，而是搞清哪个插件背后绑着几个 LSP、哪些依赖必须提前预热、哪些 .vsix 表面能装进去，实际一启用就哑火。这些细节，不踩一次坑根本记不住。
