VSCode离线安装插件不生效，主因是签名校验失败、engines.vscode版本不匹配、依赖服务未同步或远程vscode-server未正确安装；需验证.vsix完整性、检查package.json兼容性、确保所有依赖插件均已安装并强制刷新。
离线环境下插件“装上了但不工作”，90% 不是插件坏了，而是 VSCode 没真正加载它——常见于 Extension is corrupt、failed to activate、或扩展面板里显示已安装却无图标/无命令。
为什么 code --install-extension 成功了，插件还是不生效？
VSCode 安装 .vsix 后会校验签名、解析 package.json、检查 engines.vscode 兼容性，并尝试激活。任一环节失败，插件就进 disabled 状态，但 UI 不提示。
- 用
Developer: Toggle Developer Tools（Ctrl+Shift+I），切到 Console 标签，过滤activate或插件 ID（如ms-python.python），看有没有Extension 'xxx' failed to activate - 检查
engines.vscode是否匹配：在 .vsix 文件里解压出package.json，比对"engines": {"vscode": "^1.85.0"}和你本地code --version输出（如1.84.2）是否兼容 - 某些插件（如
ms-vscode-remote.remote-ssh）依赖远端vscode-server版本一致；本地装了，远程没同步，就会卡在 “Starting VS Code Server”
Extension is corrupt 真的是文件损坏吗？
不是。这个报错本质是 VSCode 在加载阶段拒绝解析，原因多为签名失效或结构污染。
- 别用压缩软件打开并保存 .vsix ——哪怕只改了个空格，签名立即失效
- macOS 下浏览器下载后可能自动解压再重打包，塞入
._隐藏文件；用unzip -t xxx.vsix验证，报broken或missing就不能用--force强装 - Windows 路径含空格时，命令行必须加双引号：
code --install-extension "D:\my ext\prettier-9.10.0.vsix" --force - Linux/macOS 忌用
~/波浪号缩写，用绝对路径：code --install-extension /home/user/vsix/python.vsix --force
语言类插件（Python/C++/Jupyter）离线后仍报错？
它们不是单个 .vsix 能搞定的——核心包只是“壳”，真正的 LSP 服务、调试器后端需额外部署，且不随 .vsix 自动分发。
-
ms-python.python依赖ms-toolsai.jupyter，两个 .vsix 都得装，顺序无关 -
ms-vscode.cpptools需要对应平台的cpptools-srv二进制（如cpptools-win32.vsix），并确认cppToolsPath设置指向正确位置 -
CodeLLDB的 .vsix 已含原生 lldb，但必须与系统架构严格匹配（x64 vs arm64），装错直接静默失败 - 首次启用时这些插件仍会尝试联网拉取资源；断网下失败后，输出面板（Ctrl+Shift+U）里常有
Failed to fetch或XHR failed提示
Remote-SSH 场景下离线安装总失败？
你在本地点“安装”，实际执行的是远程机器上的 vscode-server 进程，它完全不读你本地的 .vsix 文件。
- 必须先把 .vsix 传到远程服务器（如用
scp或 SFTP 到~/tmp/） - SSH 登录后执行：
code --install-extension ~/tmp/ms-python.python-2026.4.1.vsix - 若提示
command not found: code，说明vscode-server没注入 PATH，改用绝对路径：~/.vscode-server/bin//bin/code --install-extension ~/tmp/xxx.vsix - 远程装完后，务必在本地 VSCode 中 **完全退出再重连**，否则旧 session 会缓存失败状态
最易被忽略的一点：所有离线操作前，必须确保 VSCode 所有进程已退出。哪怕托盘里没图标，code --status 仍可能返回 PID；残留进程会让 extensions 目录锁死、缓存不刷新、甚至覆盖你刚装的插件。
