直接重装匹配的旧版VSCode是唯一可靠路径;插件禁用主因是engines.vscode字段校验失败,可通过命令面板查看Disabled插件及控制台报错确认;优先使用Marketplace的Install Another Version…安装兼容版本;若不可用,则离线下载.vsix、修改package.json中engines.vscode为宽松范围后重打包安装;Remote-SSH需同步清理远端~/.vscode-server目录。

直接重装匹配的旧版 VSCode 是唯一可靠路径,官方不提供一键回退;插件不兼容问题 95% 出在 engines.vscode 字段校验失败,而非编辑器本身“坏了”。
怎么快速确认是 engines.vscode 不匹配?
打开命令面板(Ctrl+Shift+P),输入 Extensions: Show Installed Extensions,右上角筛选器选 Disabled。如果插件出现在这里,且详情页顶部写着 Disabled due to incompatible version,基本就是它了。控制台(Help → Toggle Developer Tools → Console)里还会报红字:Extension 'xxx' is not compatible with Code '1.102.3'。别点“启用”,点了也没用——VSCode 在加载阶段就拒绝实例化。
优先试 Marketplace 的 Install Another Version…
这是最安全、免解包的操作,保留签名验证,适合大多数场景:
- 打开插件市场页,例如
https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode - 在 URL 末尾追加
?vscodeVersion=1.79.2(把1.79.2换成你本地code --version输出的精确版本) - 刷新页面,右下角出现
Install Another Version…下拉菜单 - 只选带绿色勾号 ✅ 的版本;若整个菜单灰显,说明作者已撤下所有兼容版本,需走离线路径
离线安装 .vsix 并修改 engines.vscode
内网、Marketplace 无可用旧版、或 Remote-SSH 类插件必须双端一致时,必须手动处理:
- 从插件 GitHub Releases 页面下载历史
.vsix(如fitten-code-1.3.8.vsix),优先选发布时间早于你 VSCode 版本的 release - 用
7-Zip(Windows)、Archive Utility(macOS)或unzip(Linux)解压该文件 - 编辑
extension/package.json,找到"engines": { "vscode": "^1.103.0" }这行 - 改为宽松范围,例如
"vscode": ">=1.75.0";避免写死=1.79.2,否则 minor 小更新(如 1.79.3)又会失败 - 保存后重新打包为 ZIP,再把后缀名改回
.vsix - 在 VSCode 中执行
Extensions: Install from VSIX命令安装
Remote-SSH 插件必须同步清理远端 ~/.vscode-server
这个最容易被忽略:Remote-SSH 不只是前端插件,它会在远端服务器自动部署 vscode-server 二进制。该二进制版本必须和本地 VSCode 主版本严格一致(如本地是 1.79.2,远端 ~/.vscode-server 目录就得删掉重下)。否则连接卡在 Starting VS Code Server,日志里看不到明显报错,只是一直转圈。


















