插件市场更新失败主因是engines.vscode版本不匹配导致自动禁用，需通过命令面板筛选Disabled插件、控制台红字报错或齿轮菜单显示Disable（非手动）来确认；优先在扩展面板中使用Install Another Version…安装兼容旧版，而非手动修改.vsix。
插件市场更新失败，90%以上是 engines.vscode 版本声明不匹配导致的主动禁用，不是网络或权限问题——重装、清缓存、换镜像都无效，必须对症改版本约束。
怎么确认是不是 engines.vscode 不匹配？
别猜，直接看证据：
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入Extensions: Show Installed Extensions，点右上角筛选器选Disabled；如果插件出现在这里，且详情页顶部明确标着Disabled，基本就是它了 - 控制台（
Help → Toggle Developer Tools → Console）里出现红字：Extension 'ms-python.python' is not compatible with Code '1.102.3' - 插件卡片右上角齿轮菜单显示
Disable (For All Workspaces)，但你没手动点过——这是 VSCode 自动干的 - 状态栏图标还在，但执行插件命令（比如
prettier.format）报错：command 'prettier.format' not found
优先用扩展面板装旧版，别手改 .vsix
这是最安全、最快、保留签名验证的方式：
- 在扩展面板中找到目标插件（如
esbenp.prettier-vscode），点击右下角⋯→Install Another Version… - 从列表里选一个
vscode --version输出值能覆盖的版本，例如你本地是1.91.2，就选14.0.0（其package.json中"vscode": ">=1.85.0 ） - 如果该选项灰显，说明插件作者没发布历史版本——此时才需手动处理
.vsix - 高频出问题插件：
ms-python.python、esbenp.prettier-vscode、ms-vscode-remote.remote-ssh，它们在1.102+后对engines限制明显变严
离线改 .vsix 的 package.json 必须做这三步
双击安装 .vsix 会跳过校验直接失败，必须解包→改→重打包：
- 把
.vsix文件后缀改成.zip，用 7-Zip / Archive Utility 解压 - 进入
extension/package.json，找到"engines": { "vscode": "^1.103.0" }这行，改为宽松范围，例如"vscode": ">=1.85.0 或精确匹配 <code>"vscode": "=1.91.2" - 保存后，把整个文件夹重新打包为
zip，再把后缀名改回.vsix；然后通过Extensions → Install from VSIX安装 - 注意：改完不能直接双击安装，否则仍被拒绝；也不能用
vsce package重签——离线环境没私钥，强行签名会导致插件无法加载
Remote-SSH 连不上？先同步远端 vscode-server
Remote 扩展不是纯前端插件，它会在远端自动部署 vscode-server，这个二进制版本必须和本地严格一致：
- 本地运行
code --version，记下完整版本号（如1.102.3） - 连上服务器，删掉远端旧服务：
rm -rf ~/.vscode-server - 重连时 VSCode 会自动拉取匹配版本的 server；若仍卡在
Starting VS Code Server，检查远端~/.vscode-server/bin/下目录名是否与本地版本一致 - Windows 用户注意：WSL 中的
vscode-server路径是/home/xxx/.vscode-server，不是C:\Users\...
真正麻烦的不是改哪一行，而是改完忘了远端 server 也要同步；很多人修好了本地插件，却卡在 SSH 连接上，就是因为只盯着 package.json 看，漏了远端那个隐藏的二进制版本锁。
