VS Code 扩展下载慢、安装失败怎么办：Marketplace 打不开、XHR failed 与远程开发连接全解

VS Code 大概是国内开发者装机率最高的编辑器，但它“开箱即用”的部分只有编辑器本体。真正让它好用的扩展全部要从 Marketplace 在线拉取：装一个语言支持要下载几十 MB，主题、格式化工具、调试器一个个装下来，动辄几百 MB。国内直连时的典型体验是扩展面板搜索转圈半分钟、搜索结果出来后点安装又停在“正在安装”、最后弹出一条“Error while fetching extensions. XHR failed”。用 Remote-SSH 连服务器的人还会撞上另一种卡法：本地扩展都装好了，连接远程主机时停在“正在下载 VS Code 服务端”，等几分钟后超时断开。

这几种卡法走的是三条不同的通道。扩展市场的搜索与下载来自微软的商店服务和资源分发域名；编辑器自身更新与远程服务端包来自更新通道；而 Remote-SSH 的服务端下载发生在远程主机上，与本机线路完全无关——你的电脑再快，服务器本身连不上更新通道就没用。这篇按三条通道拆开讲，先把本机扩展市场做顺，再说远程开发怎么处理。

先分清卡在哪条通道：市场、更新还是远程

这张表的关键信息是：Remote-SSH 卡住往往不是你这边的问题。服务端包是远程主机自己去下载的，如果那台机器在内网或者出口很慢，本机线路再好也不会有帮助，要么给服务器配代理，要么手动把包传上去。另外扩展装好后功能不工作，常见原因是扩展自己还要再下一份语言服务器或调试器，那属于第六条通道。微软对扩展市场与更新通道的部署会不定期调整，以官方最新说明为准。

把扩展装顺：分步操作步骤

• 第一步：先把线路准备好，连上刺猬VPN。安装客户端后自定义用户名和密码即可完成匿名注册，不需要邮箱、也不需要手机号，免费节点永久免费、不限流量，注册即用；全程 HTTPS+AES 加密传输；
• 第二步：连上后先在浏览器里打开 Marketplace 网站搜一个扩展，网页能开、详情页能出评分和下载数，说明市场检索通道已通；
• 第三步：回到编辑器，用命令面板执行“重新加载窗口”后再打开扩展面板，旧的失败请求不会自动重试，重载一次才会用新线路；
• 第四步：VS Code 默认跟随系统代理，如果连接模式选的是智能分流，确认微软的商店域名走了隧道；拿不准就临时切到全局模式装完再切回；
• 第五步：仍然报 XHR failed 的，在设置里搜索 http.proxy 与 http.proxySupport，确认没有残留的旧代理地址，改完再重载窗口；
• 第六步：大体积扩展或多次失败的，去 Marketplace 网页详情页点“Download Extension”拿到 .vsix 文件，在扩展面板菜单里选“从 VSIX 安装”离线装入；
• 第七步：Remote-SSH 卡在下载服务端时，先在远程主机上确认它能否访问更新通道；不能就把对应 commit 的服务端压缩包手动下载后放到远程主机的 .vscode-server 目录下解压；
• 第八步：登录 GitHub 或微软账号做设置同步时不要中途切换节点，授权跳转期间位置突变会让回调失败整个重来；
• 第九步：一个账号支持多设备同时在线，台式机、笔记本和 Mac 可以共用同一套配置；iPhone、iPad 上用网页版编辑器的，中国大陆区 App Store 不提供 VPN 类应用，需要用外区 Apple ID 下载客户端，见 iOS 安装教程。

按现象逐条排查：转圈、XHR failed 与远程超时

下面按扩展面板和输出面板里实际看到的提示逐条对应，先判断卡在哪条通道，再决定动作。

• 扩展面板搜索一直转圈：市场检索通道不通，浏览器打开 Marketplace 网页验证后重载窗口；
• 提示 XHR failed 或 ECONNRESET：请求被中断，检查 http.proxy 设置是否残留旧地址，切全局模式重试；
• 搜索有结果、点安装停在“正在安装”：扩展包下载通道慢，等待或改用 VSIX 离线安装；
• 装好后提示缺少语言服务器或调试器：扩展自己还要再下二进制，看输出面板里的下载地址，确认走了隧道后重装；
• Remote-SSH 停在“正在下载 VS Code 服务端”：远程主机连不上更新通道，给服务器配代理或手动上传服务端包；
• 远程连接成功但扩展在远程装不上：远程主机的市场通道不通，本地装好后用“在 SSH 中安装”同步，或把 .vsix 传到服务器安装；
• 设置同步一直等待：登录会话没保存，重新登录且过程中不切节点；
• 编辑器提示检查更新失败：更新通道不通，不影响使用，可稍后再试或手动下载安装包。

在线安装、VSIX 离线安装与镜像源怎么选

线路准备好之后，在线安装是体验最好的方式，自动更新和依赖处理都不用操心。VSIX 离线安装的价值在两种情况：一是需要把某个扩展锁在特定版本（比如新版有 bug），二是目标机器在内网没有出口。第三方镜像源在 VS Code 生态里并不主流，改配置指向非官方源还要自己评估维护方的可信度。日常开发建议把线路固定下来用在线安装，只把 VSIX 当兜底。刺猬VPN 的免费节点永久免费、不限流量、注册即用，装扩展这种断续的小体积下载用免费节点就够；经常要连远程服务器、拉容器镜像的，时长套餐期间不限流量不限速，一个账号支持多设备同时在线。实际可用性取决于当前网络环境。

远程开发专题：Remote-SSH、Dev Containers 与 WSL

远程开发是 VS Code 最容易被误判的场景，因为卡住的位置不在你面前这台电脑上。Remote-SSH 第一次连接时会在远程主机上下载与本机版本对应的 vscode-server，这一步走的是远程主机的网络：云服务器在海外一般没问题，国内机房的服务器或者公司内网机器则经常几分钟都拉不下来。处理思路有两条，一是在远程主机上配置代理让它自己拉，二是在本机浏览器里按 commit 号下载对应的服务端压缩包，通过 scp 传上去解压到 .vscode-server 目录，再重新连接。Dev Containers 的情况类似，只不过卡的是容器镜像拉取，思路见 Docker Hub 拉取镜像慢怎么办。WSL 是本机上的子系统，共享 Windows 的网络，本机线路通了它一般就通，但要注意 WSL 内部的代理环境变量要单独设置。

和其他开发工具的分工

扩展装好只是第一步，编辑器里接下来要做的几件事各有各的通道。AI 补全类扩展登录与请求走的是各家自己的服务，配置要点见 GitHub Copilot 使用指南；如果你在用基于 VS Code 的 AI 编辑器，它的扩展市场与模型请求是分开的两回事，见 Cursor 国内使用指南。

扩展面板之外，终端里跑的包管理器和 git 也各有自己的网络路径。装依赖慢或校验失败见 npm、pip、Docker 拉取慢怎么办，仓库克隆和推送慢见 GitHub 访问速度优化。这几条通道彼此独立，编辑器扩展能装不代表终端里的命令也走了隧道，排查时要分别验证。

常见报错速查表

高频问答

• 问：浏览器能打开 Marketplace 网页，编辑器里却搜不到扩展，为什么？答：编辑器保留着失败的请求状态，执行“重新加载窗口”让它用新线路重试；
• 问：XHR failed 是不是必须开 VPN 才能解决？答：多数情况是市场请求被中断，把线路准备好并清掉旧的 http.proxy 残留后重载窗口通常就好；
• 问：VSIX 离线安装安全吗？答：从 Marketplace 官方网页下载的 .vsix 与在线安装是同一个文件，安全性一致，只是不会自动更新；
• 问：Remote-SSH 一直卡在下载服务端，本机开了 VPN 也没用？答：那一步是远程主机自己在下载，与本机线路无关，给服务器配代理或手动上传服务端包；
• 问：装扩展费流量吗？答：单个扩展几 MB 到几十 MB，属于断续小体积下载，免费节点不限流量足够；
• 问：Mac 和 Windows 的配置一样吗？答：扩展市场与代理设置完全一致，只有远程开发里 WSL 是 Windows 独有，需要在子系统内单独配代理变量。

让扩展市场不再转圈：长期做法

VS Code 扩展下载慢、安装失败、XHR failed、Remote-SSH 连不上，这些问题拆开看对应三条通道：扩展市场、更新通道和远程主机自己的出口。长期做法也就三条——本机线路固定用一条延迟稳定的，扩展面板出问题先重载窗口而不是反复点安装；需要锁版本或内网部署的用 VSIX 兜底；远程开发把服务端包下载的责任放到远程主机那一侧去解决，不要在本机反复重连。

刺猬VPN 采用 HTTPS+AES 加密传输，支持自定义用户名和密码匿名注册，不需要邮箱和手机号；免费节点永久免费、不限流量、注册即用，装扩展这类断续的小体积下载用免费节点就够，时长套餐按周月年计费、期间不限流量不限速，适合同时还要连远程服务器、拉镜像、跑依赖的开发者，一个账号支持多设备同时在线。微软对扩展市场与更新通道的部署会不定期调整，以官方最新说明为准，实际可用性取决于当前网络环境。