“extension is corrupt”本质是vscode校验失败，需依次检查vsix压缩完整性、根目录package.json存在性、engines版本兼容性及进程/权限问题，而非文件真损坏。
vsix 文件报 “Extension is corrupt” 怎么快速定位真因
“Extension is corrupt” 几乎从不表示文件真被病毒破坏，而是 VSCode 在校验环节卡住了。它会检查 extension/package.json 是否存在、extension.vsixmanifest 是否合法、ZIP 文件头是否完整、签名字段是否缺失——任一失败都静默报这个错。
别急着重下，先用命令验证底层结构：
-
unzip -t your-ext.vsix（Linux/macOS）：输出OK才算压缩包完整；若报broken或missing，说明下载已损，--force也救不回来 - Windows PowerShell 运行：
Expand-Archive your-ext.vsix -WhatIf，不报错即结构可解压 - 用 7-Zip 或 Archive Utility 打开 vsix，确认根目录下有
extension/package.json—— 没这个文件，VSCode 根本不会开始解析
为什么 code --install-extension xxx.vsix --force 有时也不生效
--force 跳过版本比对和签名校验，但它不是万能钥匙。失效时优先排查这三点：
- VSCode 进程仍在运行：哪怕只留一个托盘图标，也会锁住
~/.vscode/extensions/目录。执行code --status确认无残留进程，再重试 - 权限不足：尤其 macOS SIP 或企业策略下，
~/.vscode/extensions/可能被设为只读。Linux/macOS 可临时加sudo；Windows 建议右键以管理员身份运行终端 -
engines.vscode版本硬不兼容：比如package.json里写"^1.85.0"，而你本地是1.84.2，VSCode 连解压步骤都不触发，--force完全不走逻辑。必须手动解压 vsix，查extension/package.json，再对比code --version
非官方 vsix 报 “Cannot read property 'engines' of undefined” 怎么救
这个错误明确指向 package.json 缺失或格式非法——常见于第三方镜像打包不规范、浏览器自动改后缀（如把 .vsix 存成 .vsix.zip）、或手动解压后又用普通 ZIP 工具重新打包导致元数据丢失。
修复路径很窄，但有效：
- 绝对不要用 Windows 右键“重命名”改后缀：它不改文件头，只改扩展名，VSCode 读取时直接失败。应使用 PowerShell：
Copy-Item "old.zip" "new.vsix" -Force - 如果已有解压后的源码目录（含合法
package.json），用官方工具重建：npm install -g vsce && vsce package。这是唯一能保证extension.vsixmanifest和 OPC 结构合规的方式 - 若只有损坏 vsix 且无法重下，可尝试用 7-Zip 强制解压 → 补上缺失的
extension/package.json→ 用vsce package重打。手动生成 ZIP 一定失败
离线安装后插件“显示已启用”但功能不工作？缺的是 LSP 不是 vsix
装上 ms-python.python 或 esbenp.prettier-vscode 只是注册入口，首次激活才拉 pyright、prettier CLI 或 volar-server。离线环境会卡在状态栏 “Downloading…” 或 Output 面板报 spawn ENOENT。
正确做法不是反复重装 vsix，而是迁移完整运行态：
- 在有网机器上，用**同版本 VSCode** 安装插件 → 打开对应类型文件（如
.py）→ 等状态栏不再显示下载中 → 关闭所有 VSCode 窗口 - 进入
~/.vscode/extensions/，整份拷贝对应文件夹（如ms-python.python-2024.6.0/），注意包含子目录里的node_modules和 native 二进制（如out/下的pyright） - 粘贴到离线机的相同路径，**必须彻底退出 VSCode（含托盘进程）再启动**，否则缓存不刷新，仍会尝试联网
最易忽略的一点：C++、Python、Vue 插件的功能缺失，90% 不是 vsix 损坏，而是 LSP 组件根本没落地。盯着 extension/package.json 看半天，不如去 Output 面板切到对应插件日志，搜 Downloading 更快定位断点。
