VS Code离线安装插件失败主因是环境不洁或.vsix未通过基础校验；“Extension is corrupt”多因签名失效、版本不匹配、文件损坏或网络校验干扰，需用unzip -t验证完整性、--force强制安装、确保code已加入PATH且进程已退出。
离线安装 VSCode 插件失败，90% 的问题不是插件本身坏了，而是 code --install-extension 没跑在干净环境里，或你手里的 .vsix 文件从一开始就没通过基础校验。
为什么 Extension is corrupt 总是第一个报错？
这不是文件真“损坏”，而是 VSCode 在加载阶段就拒绝解析 package.json 或验证签名失败。常见触发点：
-
.vsix实际是 ZIP，但被浏览器/杀软悄悄解压又重打包（尤其 macOS 会塞入._隐藏文件） - 手动用压缩软件打开过
.vsix并保存——哪怕只改了个空格，签名即失效 - 下载中途断开，
unzip -t xxx.vsix会直接报broken或missing，此时--force也无效 - 插件声明的
engines.vscode版本高于本地code --version输出值（比如 vsix 要求^1.85.0，你装的是1.84.2）
图形界面点“从 VSIX 安装”为什么经常静默失败？
VSCode 扩展面板依赖后台网络请求做签名验证、依赖检查和解压调度。断网时它不报错，只卡在“正在安装…”或直接消失——你根本不知道哪一步挂了。
必须改用命令行，并带上 --force 和完整路径：
- Windows：路径含空格时，必须加双引号，例如
code --install-extension "D:\vsix\ms-python.python-2024.6.0.vsix" --force - macOS/Linux：用绝对路径，避免波浪号缩写，例如
code --install-extension /Users/me/vsix/prettier-9.10.0.vsix --force - 执行前确认所有 VSCode 进程已退出：
code --status应返回空或 “no running instance” - 如果提示
command not found: code，先运行Shell Command: Install 'code' command in PATH（Ctrl+Shift+P）
C/C++、Python、CodeLLDB 这类插件离线后仍不生效？
它们不是单个 .vsix 就能搞定的——核心插件只是“壳”，真正的语言服务、调试器后端需要额外组件，且这些组件往往不打包进 vsix。
- C/C++：需单独下载对应平台的
cpptools-srv二进制包（如cpptools-win32.vsix），并确保cppToolsPath指向正确位置 - Python：
ms-python.python依赖ms-toolsai.jupyter，离线时得把两者都装上，顺序无关 - CodeLLDB：GitHub Release 页面下载的
.vsix已含原生lldb二进制，但必须与目标系统架构严格匹配（x64vsarm64） - 所有这类插件，首次启用时都会尝试联网拉取资源；若失败，输出面板（Ctrl+Shift+U）选对应通道看日志，别只盯扩展列表
装完了却在扩展列表里看不到？
VSCode 有两级缓存：内存里的 Extension Host 进程 + 磁盘上的 ~/.vscode/extensions/ 目录。二者不一致就会“已安装但不可见”。
- 先运行
Developer: Reload Window（Ctrl+Shift+P），强制刷新 Extension Host - 手动检查磁盘目录是否存在对应文件夹：
ls ~/.vscode/extensions | grep 插件ID（Linux/macOS）或dir %USERPROFILE%\.vscode\extensions（Windows） - 如果目录里有但没加载，大概率是权限问题：该目录不能被设为只读（尤其 WSL 挂载 NTFS 分区、企业策略锁定用户目录时）
- 终极手段：删掉
~/.vscode/extensionsCache目录再重启 VSCode——这是元数据索引缓存，损坏后插件描述都读不出来
真正卡住人的从来不是“怎么装”，而是装完之后发现功能缺失、跳转失效、终端不识别解释器——这些都不是离线安装流程的问题，而是你没意识到那些“看不见的依赖”也需要一并离线部署。
