根本原因是插件 package.json 中 engines.vscode 字段与本地 VS Code 版本不匹配，VS Code 会严格校验并拒绝安装或启动；即使升级 VS Code，插件作者可能已收紧版本范围，且修改后需重打包为 .vsix 才生效。
根本原因就一个：插件 package.json 里的 engines.vscode 字段和你本地 code --version 不匹配。 VS Code 在安装或启动时会严格校验这个字段，不满足就直接拒之门外——不是“可能出错”，而是“连解压都不做”。
为什么改了 VS Code 版本也救不了插件？
VS Code 主程序升级后，engines.vscode 的语义没变，但插件作者可能收紧了范围。比如：
- 旧版插件写
"vscode": "^1.85.0"，你用 1.85.2 能装；新版插件改成"vscode": "^1.102.0"，你还是 1.85.2，就直接被拦在安装界面外 - 某些插件（如
ms-python.python、esbenp.prettier-vscode）从 1.102+ 开始强制要求新版，历史版本市场页面里Install Another Version…常灰显——作者根本没发布兼容旧主程序的包 -
^1.85.0表示 “≥1.85.0 且 ^1.86.0，照样不认
离线安装时提示不兼容，其实是校验提前了
内网机器无法连 Marketplace，只能靠 .vsix 文件手动装。但 .vsix 不是“免检通道”——它本质是 zip，VS Code 安装前会打开并读取 extension/package.json 中的 engines.vscode，发现不匹配就弹 Unable to install extension 'xxx' as it is not compatible with VS Code '1.xx.x'，进度条卡住，文件甚至没落地。
- 双击 .vsix 或拖进扩展面板 = 必然失败，校验逻辑完全绕不过
- 必须用命令面板执行
Extensions: Install from VSIX，但前提是先改好engines.vscode - 注意路径：要改的是
extension/package.json，不是根目录那个同名文件——改错位置等于白干
改 engines.vscode 时最容易踩的坑
字段看似简单，但写法差一点就失效：
- 别写死
"=1.85.0"：minor 小更新（如 1.85.1）会被拒绝，应写">=1.85.0"或"^1.85.0 || ^1.90.0" - 别漏掉引号和逗号：JSON 格式必须严格，
"vscode": ">=1.85.0"是对的，vscode: >=1.85.0会报解析错误 - 改完必须重打包为 zip 再改后缀为 .vsix：直接保存原 vsix 文件不生效，因为 zip 结构已损坏
- Remote-SSH 类插件还要同步远端
~/.vscode-server版本，否则即使本地装上，连接仍卡在Starting VS Code Server
真正麻烦的从来不是改一行 JSON，而是改完发现插件运行时报 TypeError: xxx is not a function——说明它调用了已被移除的 API。这时候就得查源码、看 release note，或者等作者适配。字段能骗过安装器，骗不过运行时。
