插件因版本不兼容被禁用，可确认：Disabled列表中显示该插件、控制台报“not compatible with Code”、命令执行提示“command 'xxx' not found”、右键菜单仅显示“Disable (For All Workspaces)”。
怎么确认插件是因版本不兼容被禁用
插件没反应、命令报 command 'xxx' not found、右上角齿轮菜单显示 Disable (For All Workspaces)，但你没手动点过——这基本就是 engines.vscode 不匹配导致的自动禁用。打开命令面板（Ctrl+Shift+P），输入 Extensions: Show Installed Extensions，点右上角筛选器选 Disabled，如果插件出现在这里，且详情页顶部明确写着 Disabled，就坐实了。
Install Another Version… 为什么有时灰显或不出现
这个菜单项只在插件「已安装」状态下才可见；如果插件根本没装过，得先装一次最新版再右键触发。它灰显通常有两个原因：
- 插件作者已撤下所有历史版本（比如
ms-python.python在 1.102+ 后删掉了 2022 年前的 release） - 你当前 VSCode 版本低于 1.63（2021 年底起才内置支持）
解决办法：把 Marketplace 页面 URL 末尾加上 ?vscodeVersion=1.79.2（换成你本地 code --version 输出的精确版本），刷新后右下角会出现 Install Another Version… 下拉菜单——只选带绿色勾号 ✅ 的版本。
离线安装 .vsix 时改 engines.vscode 的关键细节
.vsix 是 zip 包，双击安装会跳过校验直接失败。必须解包、改 extension/package.json（注意不是外层的 package.json），再重打包：
- 用
7-Zip（Windows）、unzip（Linux）或 Archive Utility（macOS）解压 - 找到
extension/package.json，修改"engines": { "vscode": "^1.103.0" }这一行 - 推荐改成宽松范围，如
"vscode": ">=1.75.0"；避免写死"=1.79.2"，否则 minor 小更新（如 1.79.3）又不认 - 保存后重新打包为 zip，再把后缀名改回
.vsix
最后通过命令面板运行 Extensions: Install from VSIX 安装。改完不生效？别忘了执行 Developer: Reload Window，否则缓存还在用旧元数据。
Remote-SSH 类插件的双端一致性最容易被忽略
这类插件（如 ms-vscode-remote.remote-ssh）不是单靠改本地 engines 就能搞定的。它前端跑在本地 VSCode，后端还要在远端机器部署 vscode-server 二进制，这个二进制版本必须和本地主程序严格一致。降级 VSCode 后，远端 ~/.vscode-server 目录若没清理，连接就会卡在 Starting VS Code Server。务必先在远端执行 rm -rf ~/.vscode-server，再重连。
