VSCode提示“扩展包损坏”通常不是文件真损坏，而是校验失败：1）下载不完整；2）缺少extension/package.json；3）engines.vscode版本不匹配；4）含隐藏元数据或签名失效。
VSCode 提示“扩展包损坏”，基本不是文件真坏了，而是校验阶段被拒绝——它压根没开始解压，就因签名、结构或版本问题直接报错。
vsix 文件校验失败的四个常见原因
VSCode 1.77+ 默认启用强签名验证，Extension is corrupt 这类错误多数是校验卡点，不是 ZIP 解压失败：
-
unzip -t xxx.vsix报broken或missing：文件下载不完整，重下即可（别信文件大小） - 根目录缺
extension/package.json：非官方打包或手动改包导致结构缺失，用vsce package重打 -
package.json里"engines": {"vscode": "^1.92.0"}，而你本地是1.90.0：VSCode 直接拒载，--force都不触发 - 文件含 macOS 的
._隐藏元数据或杀软注入：用zip -d xxx.vsix '._*'清理，或换浏览器/curl 下载
code --install-extension --force 不生效？先查这三点
--force 跳过版本比对和签名检查，但前提是 VSCode 能走到安装逻辑。失效往往卡在环境层：
- VSCode 进程仍在运行：Windows 任务管理器杀光所有
Code.exe和Code Helper.exe；macOS 活动监视器里清空全部Code相关进程 - 目标目录权限不足：
~/.vscode/extensions/被只读锁定（尤其企业策略或 macOS SIP），执行sudo chown -R $(whoami) ~/.vscode -
package.json中engines.vscode版本高于当前 VSCode：运行code --version对比，不匹配就只能升级 VSCode 或换旧版 vsix
用 open-vsx.org 替换微软源时 itemUrl 必须显式配置
只改 serviceUrl 不够，点击安装会 404。VSCode 需要两个端点协同工作：
{
"extensions.gallery": {
"serviceUrl": "https://open-vsx.org/vscode/gallery",
"itemUrl": "https://open-vsx.org/vscode/item"
}
}
漏掉 itemUrl，或 URL 末尾少 /（如写成 https://open-vsx.org/vscode/item），VSCode 就静默失败，不报错也不提示。
离线安装前必须确认 vsix 是 ZIP 结构且未被篡改
vsix 就是 ZIP，但 VSCode 对格式极其敏感：
- 双击打不开？先用
unzip -l xxx.vsix看输出是否含extension/package.json和[Content_Types].xml - 用
vsce verify xxx.vsix（需装vsce）可检测 OPC 规范合规性 - 从非官网下载的 vsix，哪怕 MD5 匹配，也可能被中间设备重写（比如某些企业网关会注入 JS），优先走 Marketplace 原始链接
真正难搞的不是“损坏”，而是 VSCode 在不同环节用不同规则做校验：网络层看域名 TLS、下载层看 ZIP 完整性、安装层看签名、加载层看引擎版本——漏掉任一环，都会统一报“corrupt”。
