VSCode升级后插件不兼容主因是engines.vscode字段不匹配当前版本，需先检查是否被禁用（Extensions: Show Installed Extensions → Disabled），再通过Install Another Version…安装匹配历史版或解包修改package.json中的engines.vscode值。
VSCode 升级后插件不兼容，绝大多数情况不是插件“坏了”，而是被主动禁用或根本没加载——关键看 engines.vscode 字段是否匹配你当前的 code --version 输出值。强行重启、重装、清缓存都没用，得先确认禁用状态，再针对性处理。
怎么快速确认插件是因版本不兼容被禁用
打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入并执行 Extensions: Show Installed Extensions；点击右上角筛选器，选 Disabled。如果目标插件（比如 ms-python.python 或 fitten.fitten-code）出现在这里，且详情页顶部明确写着 Disabled，基本就是 engines.vscode 不满足。控制台（Help → Toggle Developer Tools → Console）里常出现红字：Extension 'xxx' is not compatible with Code '1.118.0'。别信状态栏图标——它可能只是 UI 残留；直接输插件命令（如 prettier.format）看是否报 command 'xxx' not found。
优先用 Marketplace 安装匹配的历史版本
扩展面板里点插件右下角 ⋯ → Install Another Version…，选一个和你当前 code --version 匹配的旧版。这个操作比改 .vsix 安全、省事，且保留市场签名验证。高频出问题的插件包括：ms-python.python、esbenp.prettier-vscode、ms-vscode-remote.remote-ssh，它们在 1.102+ 后对引擎限制明显变严。若该菜单灰显，说明作者未发布任何与你版本匹配的历史 release，必须转向离线修改方案。
离线安装 .vsix 时提示版本不兼容？解包改 engines.vscode
.vsix 本质是 zip 包，不能双击安装，否则跳过校验直接失败。必须解包、改 package.json、重打包：
- 用
7-Zip（Windows）、Archive Utility（macOS）或unzip（Linux）打开.vsix - 进入
extension/package.json（注意不是外层根目录那个） - 找到
"engines": { "vscode": "^1.103.0" }这一行，改为宽松范围，例如"vscode": ">=1.75.0"或精确锁定为"vscode": "=1.118.0"（把1.118.0替换为你本地code --version输出的第一段） - 保存后重新打包为 zip，再把后缀名改回
.vsix - 在 VSCode 中执行
Extensions: Install from VSIX命令安装
改完仍不生效？可能是插件代码本身调用了新版已移除的 API（比如 workspace.findFiles 的某个废弃选项），这时控制台会报 TypeError: xxx is not a function，需查源码或等作者更新。
Remote-SSH / WSL 连接卡在 Starting VS Code Server？远端 vscode-server 版本必须严格一致
Remote 扩展不是纯前端插件——它会在远端自动部署一个 vscode-server 二进制。这个 server 版本必须与本地 VSCode 主程序严格对应。比如本地是 1.118.0，远端却拉取了 1.117.2 的 server，就会卡住或报 Failed to fetch commit hash。降级 VSCode 后，务必先删掉远端的 ~/.vscode-server 目录再重连。内网或锁版本场景下，这点最容易被忽略，且错误现象和插件兼容性问题高度相似，但根源完全不同。
