vscode提示“安装似乎损坏”并非真损坏,而是background等插件篡改核心文件致校验失败;应安装fix vscode checksums扩展,执行fix checksums: apply命令并完全重启vscode。

VSCode 启动报错且右下角提示“Code 安装似乎损坏”,大概率不是真损坏,而是插件市场安装的某个扩展篡改了核心校验文件——直接重装是绕远路。
为什么装个插件会触发“安装损坏”警告
VSCode 会对自身可执行文件和关键资源(如 product.json、resources/app/package.json)做 SHA256 校验。某些插件(尤其是 background 类、主题增强类或早期未严格遵循 API 的插件)在激活时会尝试 patch 主进程或写入非标准路径,意外修改了这些受保护文件,导致校验失败。
典型现象包括:
- 启动后标题栏带
[不受支持]字样 - 右下角持续弹出
Code 安装似乎损坏。请重新安装。 -
Developer: Show Running Extensions无法打开,或扩展列表空白
用 Fix VSCode Checksums 快速修复校验失败
这个扩展不修改任何功能,只做一件事:重新生成并写入正确的校验值到本地配置中。它比手动计算哈希、替换文件安全得多。
操作步骤:
- 从 Marketplace 搜索
Fix VSCode Checksums并安装(若在线失败,去官网页面点Download Extension手动下载.vsix,再用Extensions: Install from VSIX安装) - 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Fix Checksums: Apply并回车 - 看到提示
Checksums applied. Please restart VSCode to see effect后,**必须完全退出 VS Code 进程**(任务管理器里确认Code和Code Helper全部消失),再重新启动
注意:Fix Checksums 不会恢复被插件删改的原始文件内容,只重置校验逻辑;如果某个插件已造成深层破坏(比如覆盖了 icudtl.dat),需配合其他修复手段。
安装失败时如何绕过市场直连,避免损坏包流入
国内直连 marketplace.visualstudio.com 常因 TLS 握手失败或中间劫持,导致下载的 .vsix 实际是 HTML 错误页,但 VS Code 仍尝试解压安装,结果签名失效、文件结构错乱。
更稳的替代方案:
- 禁用自动更新:
"extensions.autoUpdate": false加入settings.json - 换用稳定服务地址:
"extensions.gallery.serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery/"(注意末尾斜杠不能少) - 手动下载优先:访问插件页面(如
https://marketplace.visualstudio.com/items?itemName=ms-python.python),点右侧Download Extension,得到原始.vsix;校验 SHA256(官网页面下方有哈希值)后再安装 - 绝对不要解压
.vsix文件再重打包——它含数字签名,ZIP 结构微调即失效
修复后仍报错?重点检查三个隐藏位置
即使校验通过,旧损坏可能残留。以下路径必须人工确认:
-
%USERPROFILE%\.vscode\extensions\(Windows)或~/.vscode/extensions/(macOS/Linux):删除名称含.incomplete或时间戳异常的空文件夹 - 用户数据目录下的
GPUCache和Cache子目录(路径见%APPDATA%\Code等):这些缓存损坏会导致 exthost 启动即崩溃,且不报具体错误 - VS Code 安装目录里的
_或—隐藏文件夹(Windows 常见):更新中断时 icu 文件会卡在这里,必须全量复制覆盖到上一级主目录
最易被忽略的是:你以为修复了校验,但 exthost 进程仍在加载一个早已损坏却未被卸载的扩展——Developer: Open Extension Host Log 底部最后一行 ERROR 才是真实线索,别只盯着“安装损坏”四个字。











