“Extension is corrupt”通常非文件真损坏，而是VSCode校验失败所致；应先用unzip -t或Expand-Archive验证结构完整性，若OK则检查签名、隐藏文件或改从Marketplace官网重下原始.vsix。
code --install-extension 报 “Extension is corrupt” 怎么办
这不是文件真损坏，而是 VSCode 在校验阶段拒绝加载——常见于下载不完整、手动解压重打包、或杀软拦截写入。直接用 unzip -t plugin.vsix（macOS/Linux）或 Expand-Archive -Path plugin.vsix -WhatIf（PowerShell）验证 ZIP 结构是否完整。报错就重下；若显示 OK 却仍提示 corrupt，大概率是签名被破坏或含隐藏元数据（比如 macOS 的 ._ 文件），此时必须从 Marketplace 官网重新下载原始 .vsix，别信第三方网盘链接。
安装后插件不显示、不生效的三个硬检查点
装完重启还是没反应？先确认这三项是否全部满足：
-
settings.json里没有误写"locale": "zh-cn"（中文包必须是zh-hans） - 插件目录
~/.vscode/extensions/（Windows 是%USERPROFILE%\.vscode\extensions）下存在对应文件夹，且该目录归属当前用户、非只读 - 执行
code --status确认无残留进程；若有，强制 kill 后再运行code --install-extension xxx.vsix
“not compatible with Code” 错误的快速修复路径
本质是 package.json 里的 "engines": {"vscode": "^1.85.0"} 和你本地 code --version 输出的版本不匹配。别删插件重试，直接解压 .vsix（它就是 ZIP），打开根目录下的 extension/package.json，把 engines.vscode 改成你实际版本的主版本号范围（例如你用的是 1.90.2，就改成 "^1.90.0"），再用 7-Zip 或 zip -r 重新打包，后缀改回 .vsix。Windows 资源管理器双击解压会破坏结构，务必避开。
离线装 C/C++、Python 这类带语言服务的插件，漏掉依赖就白装
这类插件不是装上就完事，它们会在首次启用时自动下载额外组件（如 C/C++ language components 或 pyright），而离线环境会静默失败，表现为“未找到定义”“跳转失效”。必须一并下载对应组件包：
- 进插件官网页 → 拉到“Resources”栏 → 找 “Download Language Service” 类按钮（不是 Download Extension）
- 组件包通常为
.tar.gz或.zip，解压后按插件文档说明放入~/.vscode/extensions/ms-vscode.cpptools-*/dist/或~/.vscode/extensions/ms-python.python-*/pythonFiles/对应路径 - 装完重启，打开 Output 面板选 “C/C++” 或 “Python”，确认日志里不再出现
Downloading package 'xxx' Failed
最常被忽略的是：VSCode 的扩展管理器在离线时不会主动报“缺组件”，只会让功能静默降级。你得去 Output 面板翻日志，而不是凭界面表现判断是否装成功。
