“extension is corrupt”通常非文件真损坏，而是vscode解析package.json、校验签名、版本不匹配（如本地1.92 vs插件要求^1.93.0）、架构不符（arm装x64包）、权限不足或路径错误导致的静默拒绝。
vscode --install-extension 报 “Extension is corrupt” 怎么确认真伪
这个报错几乎从不表示文件真的损坏，而是 VSCode 在解析 package.json 或校验签名时被卡住。它不提示具体哪一行出问题，只甩一句“corrupt”，让人误以为要重下包。
- 先用
unzip -t plugin.vsix检查压缩包完整性：输出含OK才算结构完好；若报missing 123 bytes或invalid compressed data，才是真损坏 - 再看顶层结构：
unzip -l plugin.vsix | head -10，必须能看到extension/package.json在第一级目录；如果列出的是package.json、icon.png等零散文件，说明已被解压或二次打包过 - 别信浏览器自动加的
.zip后缀：Windows 下右键重命名为.vsix会破坏文件头；正确做法是 PowerShell 中执行Copy-Item "xxx.zip" "xxx.vsix" -Force
engines.vscode 版本不匹配导致静默拒绝安装
VSCode 不会因版本低就报明确错误，而是直接跳过安装——插件列表里没它，~/.vscode/extensions/ 下也没文件夹，连日志都不写。这是离线场景下最隐蔽的失败点。
- 运行
code --version，取前两位（如1.92.2→1.92） - 解压查看要求：
unzip -p plugin.vsix extension/package.json | grep engines，关注"vscode": "^1.85.0"这类字段 - 本地版本必须 ≥ 插件声明的最小值；差一个小版本（如
1.92vs^1.93.0）就会被静默丢弃 - ARM 架构（M 系列 Mac / Linux ARM64）不能装 x64 构建的包：Help → About 看架构，再去 Marketplace 的
/versionhistory页面手动选对应平台旧版
权限与路径问题让安装“假装成功”
VSCode 命令行安装时不会主动检查目标目录是否可写。它尝试解压、失败、然后沉默退出——你看到命令返回了，但 ~/.vscode/extensions/ 下空空如也。
- 确认写入权限：
ls -ld ~/.vscode/extensions/，输出中要有drwxr-xr-x且属主是你自己；若提示Permission denied，运行chown -R $(whoami) ~/.vscode - 路径必须用绝对路径：
code --install-extension /home/user/Downloads/ms-python.python-2024.6.0.vsix；~/Downloads/或./plugin.vsix会被忽略 - Windows 路径含空格或中文？必须用英文双引号包裹：
code --install-extension "C:\my ext\python.vsix" - 别加
sudo：否则插件装进/root/.vscode/extensions/，普通用户启动 VSCode 后完全不可见
语言服务器缺失导致插件“装上了却不工作”
很多插件（如 ms-python.python、Vue Language Features (Volar)）安装只是注册，首次启用才触发语言服务器（LSP）下载。离线时它卡在状态栏 “Downloading…” 或 Output 面板报 spawn ENOENT，看起来像安装失败，其实不是。
- 在有网机器上完整走一遍流程：打开一个
.py文件 → 等状态栏不再显示 “Downloading pyright” → 再去~/.vscode/extensions/下拷整个插件文件夹（如ms-python.python-2024.6.0/） - 必须整目录拷，不能只拷
.vsix；关键二进制（如pyright-server）藏在子目录out/或dist/里 - 拷完后彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，新文件不生效
