90%插件安装失败或被禁用是因engines.vscode字段不匹配，需修改extension/package.json中该字段为本地vs code兼容版本并重载窗口。
插件安装失败或被禁用，90% 是 engines.vscode 字段不匹配导致的，不是插件坏了，也不是网络问题——VS Code 在加载前就按这个字段做硬性拦截，改对位置、改对范围，5 分钟就能恢复使用。
怎么确认是 engines.vscode 导致的不兼容
别猜，直接看证据：
- 安装时弹出
Unable to install extension 'xxx' as it is not compatible with VS Code '1.xx.x' - 已安装插件显示为 Disabled，右键菜单只有
Disable (For All Workspaces)，没有启用选项 - 命令面板输入
Extensions: Show Installed Extensions→ 点右上角筛选器选Disabled，插件出现在列表里 - 开发者工具（
Help → Toggle Developer Tools）Console 标签页里有红字：Extension 'ms-python.python' is not compatible with Code '1.102.3'
离线安装 .vsix 时提示版本不兼容，必须解包改 package.json
.vsix 就是 zip，双击拖拽安装会直接失败，因为校验发生在解压前。必须手动干预元数据：
- 用
7-Zip（Windows）、Archive Utility（macOS）或unzip（Linux）解压xxx.vsix - 进入
extension/package.json（注意：不是根目录那个package.json） - 找到
"engines": { "vscode": "^1.103.0" }这一行 - 改成宽松范围，例如
"vscode": ">=1.85.0"或"vscode": "^1.90.0"（值必须和你本地code --version输出一致或兼容） - 保存后，把整个文件夹重新打包为 zip，再把后缀名改回
.vsix - 在 VS Code 中运行命令
Extensions: Install from VSIX安装改过的包
插件已安装但被禁用，可直接改本地 package.json 并重载
不用卸载重装，改完立刻生效（但 VS Code 升级后该字段会被重置）：
- 关闭 VS Code
- 定位插件目录：
~/.vscode/extensions/作者名.插件名-版本号/（Linux/macOS）或%USERPROFILE%\.vscode\extensions\作者名.插件名-版本号\（Windows） - 编辑该目录下的
package.json，修改engines.vscode值 - 启动 VS Code，执行命令面板中的
Developer: Reload Window（仅点「启用」无效）
Remote-SSH / Remote-Containers 类插件要额外处理远端 vscode-server
这类插件前端只是“遥控器”，远端 vscode-server 的二进制版本必须和本地 VS Code 主版本严格一致：
- 本地是
1.102.3，远端~/.vscode-server目录下却有1.103.0的 server，连接就会卡在Starting VS Code Server - 解决方法：在远端机器执行
rm -rf ~/.vscode-server，然后重连，VS Code 会自动拉取匹配的 server 版本 - 如果远端无法联网，需手动下载对应版本的
vscode-server-linux-x64.tar.gz（注意平台和 commit hash），解压到~/.vscode-server/bin/xxx...目录
最常被忽略的是改错位置：必须改 extension/package.json 里的 engines.vscode，而不是外层 .vsix 解压根目录下的同名文件；另外，改完不重载窗口或不删远端 server，问题一定还在。
