VSCode插件离线安装需确保.vsix版本与VSCode主版本及架构严格兼容，通过官方市场下载后，可用拖拽主窗口、code --install-extension命令或手动解压至extensions目录三种方式安装，但语言插件还需额外部署LSP服务器等离线依赖。
VSCode 插件更新卡在“正在下载”或报 XHR failed，**不是插件坏了，而是网络链路断了**——代理配置错位、Remote 场景配错位置、或根本连不上 marketplace.visualstudio.com。离线方案不是备选，而是最可控的兜底手段。
确认是不是真需要离线：先看 Network 请求是否失败
别急着下 .vsix。先打开命令面板（Ctrl+Shift+P），运行 Developer: Toggle Developer Tools，切到 Network 标签页，再点一次“Update All”。重点观察：
- 有没有大量
marketplace.visualstudio.com请求状态为0、pending超过 30 秒，或直接net::ERR_CONNECTION_RESET - 有没有
vscode-api相关域名请求失败 - 如果全是灰色或无响应，基本可判定是网络层阻断，离线安装就是合理路径
离线安装.vsix：三步走，但版本和路径必须严丝合缝
手动下载的 .vsix 文件若装不上，90% 是因为版本不匹配或路径错误。C++、Python、Prettier 这类核心插件尤其敏感：
- 在扩展面板里右键点击目标插件 →
Copy Extension ID（如ms-python.python） - 浏览器打开
https://marketplace.visualstudio.com/items?itemName=ms-python.python，点右下角Download Extension→ 得到ms-python.python-2026.4.1.vsix这类文件 - 安装方式二选一：
• 双击该文件（Windows/macOS）；
• 或命令行执行code --install-extension /path/to/ms-python.python-2026.4.1.vsix - ⚠️ 注意：
.vsix文件名里的版本号必须和你当前 VS Code 版本兼容（比如 VS Code 1.88 不支持要求引擎^1.90.0的插件）
Remote-SSH 场景下离线更麻烦：.vsix 要传到远程机器上装
你在本地点了“安装”，实际执行的是远程服务器上的 vscode-server 进程。它不认你本地的代理，也不读你本地的 .vsix ——你得把文件传过去再装：
- 用
scp或 SFTP 把.vsix上传到远程服务器任意路径（如~/tmp/） - SSH 登录后，执行：
code --install-extension ~/tmp/ms-python.python-2026.4.1.vsix - 如果提示
command not found: code，说明vscode-server没把code命令注入 PATH，改用绝对路径：~/.vscode-server/bin/<hash>/bin/code --install-extension ...</hash> - 装完别忘了重连 Remote-SSH，否则新插件不会激活
离线不是万能的：C++ 插件的语言服务组件还得单独下
像 ms-vscode.cpptools 这类插件，装完 .vsix 后还会自动下载平台专属的语言服务（C/C++ language components (Windows)）。这个下载失败，VS Code 只会报 Downloading package Failed，且不会提示你缺什么。
解决方法：
- 去 GitHub 官方 release 页面：
https://github.com/microsoft/vscode-cpptools/releases - 找和插件版本一致的发布（如插件是
1.15.0，就选v1.15.0标签） - 下载对应平台的
cpptools-win32.vsix（Windows）、cpptools-osx.vsix（macOS）等独立包 - 同样用
code --install-extension在本地或远程装
这一步最容易被跳过，结果就是插件显示已启用，但 IntelliSense 和调试完全不工作。
