直接改 engines.vscode 字段是最常用、最有效的解法，90% 的“Extension is not compatible with Code”报错都源于此；VSCode 1.85+ 强制校验该字段，不满足即拦截安装，需解压.vsix修改 extension/package.json 中的 engines.vscode 值为宽松范围（如 ">=1.85.0"），重打包后通过 Extensions: Install from VSIX 安装。
直接改 engines.vscode 字段是最常用、最有效的解法，90% 的“Extension is not compatible with Code”报错都卡在这儿。VSCode 1.85+ 起强制校验该字段，不满足就拦在安装前——不是插件坏了，是它“身份证”上写的最低准入版本比你高。
怎么确认是 engines.vscode 不匹配
别靠猜。打开命令面板（Ctrl+Shift+P），输入 Extensions: Show Installed Extensions，右上角筛选器选 Disabled。如果插件出现在这儿，且详情页顶部写着 “Disabled due to incompatible version”，基本就是它了。再看控制台（Help → Toggle Developer Tools → Console）有没有红字：Extension 'xxx' is not compatible with Code '1.102.3'。这两条同时命中，不用往下看了，就是 engines.vscode 拦的。
离线安装 .vsix 时被拒：解包→改 package.json→重打包
.vsix 就是 zip，双击或拖拽安装会直接失败，因为 VSCode 在加载第一帧就检查 engines.vscode。必须手动干预：
- 用
7-Zip（Windows）、unzip（Linux/macOS）或系统自带归档工具解压xxx.vsix - 进
extension/package.json（注意：不是根目录那个，是extension/子目录下的） - 找到
"engines": { "vscode": "^1.103.0" }这行，改成宽松范围，例如："vscode": ">=1.85.0"或"vscode": "^1.85.0 || ^1.102.0" - 保存后，把整个
extension/目录（确保顶层是它）重新打包为 zip，再把后缀名改回.vsix - 在 VSCode 中运行
Extensions: Install from VSIX命令安装
已安装插件被禁用：直接改本地 package.json 并重载窗口
插件已经存在但灰了，不想重装？可以跳过 .vsix 流程，直改本地元数据：
- 定位插件目录：
~/.vscode/extensions/作者名.插件名-版本号/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\作者名.插件名-版本号\（Windows） - 编辑该目录下的
package.json，修改engines.vscode字段值 - 改完不能只点「启用」，必须执行命令面板中的
Developer: Reload Window - 注意：VSCode 更新后这个字段会被自动还原，得重复改
Remote-SSH 类插件要额外处理远端 vscode-server
这类插件不是纯前端，它会在远端机器部署 vscode-server，这个二进制版本必须和本地 VSCode 主版本严格一致。哪怕只差一个 patch 号（比如本地 1.102.3，远端拉了 1.102.4 的 server），连接就会卡在 Starting VS Code Server。
修复方法很直接：ssh 登远端，删掉 ~/.vscode-server，然后重连——VSCode 会自动下载匹配的 server 版本。别省这一步，否则改再多本地配置都没用。
