加--force强制安装可解决“extension is corrupt”问题，因其跳过版本比对与签名校验；但须确保vscode已完全退出、用户对extensions目录有写权限，且vsix声明的engines.vscode版本不高于当前vscode版本。
code --install-extension 报 “Extension is corrupt” 怎么办
这不是网络或文件损坏，而是 VSCode 拒绝覆盖已存在的同名扩展——哪怕你手动删过 ~/.vscode/extensions/ 目录，残留的 registry 缓存仍会让它校验失败。最直接的解法是加 --force 参数，跳过版本比对和签名检查，强制解压写入。
使用前确认三点：
- VSCode 必须完全退出（包括后台进程，macOS 可用
killall Code，Linux 用pkill code） - 确保当前用户对
~/.vscode/extensions/有写权限；若被锁定，Linux/macOS 下可试sudo code --install-extension xxx.vsix --force - 检查 vsix 声明的
engines.vscode版本是否兼容：解压 vsix（它本质是 ZIP），打开extension/package.json，对比code --version输出
vsix 文件本身是否完整？别靠文件大小判断
很多“损坏”其实是下载不全。vsix 是标准 ZIP 包，用系统命令快速验证：
- Linux/macOS：
unzip -t my-ext.vsix—— 输出OK才算完整 - Windows PowerShell：
Expand-Archive my-ext.vsix -WhatIf—— 不报错即结构正常
如果 unzip -t 提示 broken 或 missing，--force 也救不回来，必须重下。
为什么 --force 还是失败？重点看 engines.vscode 版本
这是最容易被忽略的卡点：VSCode 会直接拒绝加载 engines.vscode 要求高于当前版本的 vsix，连解压步骤都不触发。比如 vsix 要求 "^1.85.0"，而你运行的是 1.84.2，此时 --force 完全无效。
验证方式很简单：
- 用
code --version查当前版本 - 用
unzip -p my-ext.vsix extension/package.json | grep engines（Linux/macOS）或解压后手动打开package.json查engines.vscode字段
离线安装时如何避免反复踩坑
强制覆盖只是补救手段，真正省事的做法是提前控制输入源：
- 优先从官方市场下载 vsix（地址形如
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/xxx/vsextensions/xxx/1.2.3/vspackage），避免第三方镜像缺失extension.vsixmanifest - 安装前先执行
code --list-extensions | grep -i xxx确认旧版是否真被卸载干净 - 企业环境若禁用了
--force，可临时改用code --extensions-dir /tmp/vscode-exts指定全新扩展目录，绕过旧缓存
真正麻烦的从来不是命令本身，而是没看清 engines.vscode 和本地版本那半个小数点的差距。
