VSCode插件市场卡在“正在加载”或安装失败,90%是因extensions.gallery.serviceUrl配置错误而非网络问题:必须带完整协议和末尾斜杠(如"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"),且需同步配置同值的cacheUrl,大小写敏感,镜像源须一致;http.proxy仅影响次要请求,对市场无效。

VSCode插件市场卡在“正在加载”或安装失败,90% 不是网络断了,而是 http.proxy 配错了位置、格式或生效范围——它根本没进代理进程,或者压根没被读取。
为什么填了 http.proxy 还是连不上 Marketplace?
VSCode 的扩展市场页面(搜索/安装/更新)不走 http.proxy 配置,它只认 extensions.gallery.serviceUrl。你填的 "http.proxy": "http://127.0.0.1:7890" 只影响 GitHub 登录、自动更新检查等次要请求,对主市场加载完全无效。
- 填错格式(如漏掉
http://前缀、写成localhost:7890)→ VSCode 静默忽略该配置 -
127.0.0.1和localhost默认被系统 bypass 规则拦截,请求直连,根本不到代理端口 - Remote-SSH 场景下,本地
http.proxy对远程vscode-server进程 100% 无效 - 代理服务未开启 HTTP 端口(Clash 默认只开 SOCKS5,需手动启用
allow-lan: true并暴露 HTTP 端口)
extensions.gallery.serviceUrl 配错就白忙
这才是控制插件市场流量的“总开关”。改它,所有市场请求才真正走新地址。但极易因格式错误静默失效:
- 必须带完整协议+路径,末尾必须有
/:"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"✅;少一个斜杠 → 404,界面卡住不报错 - 必须同步配
extensions.gallery.cacheUrl,且值与serviceUrl完全一致,否则 publisher 列表空白 - 大小写敏感:
extensionGallery不能写成extensiongallery或ExtensionGallery - 别混用镜像源:
serviceUrl指向azure.cn,cacheUrl却指向open-vsx.org→ 签名校验失败或部分请求 404
Remote-SSH 场景下代理必须单独配远程机
本地 VSCode 的任何设置(包括 UI 里填的 http.proxy)都不会透传到远程服务器。真正起作用的是远程机器上的这个文件:
- 路径:
~/.vscode-server/data/Machine/settings.json(注意是Machine,不是User或Remote) - 内容只需最小集:
{"http.proxy":"http://192.168.1.100:7890","http.proxyStrictSSL": false}(地址必须是远程机器能直连的局域网 IP,别用127.0.0.1) - 改完必须彻底断开 SSH 连接,再重连——
vscode-server启动时才加载该文件,热重载不生效 - 验证方式:SSH 登远程后执行
curl -I https://marketplace.visualstudio.com,返回200才算通
改完设置为什么还是没反应?
因为 VSCode 后台服务进程(Code Helper)仍在运行,它缓存着旧的市场地址,新配置根本没加载。只关窗口、点“重新加载窗口”完全无效:
- Windows:右键任务栏图标 → “退出”;再打开任务管理器,结束所有
Code.exe和Code Helper.exe - macOS:活动监视器中搜索并强制退出全部
Code和Code Helper - Linux:
pkill -f "code"或killall -9 code - 命令行启动的用户注意:
code --new-window≠ 彻底重启,必须杀进程再重开
真正容易被忽略的是:http.proxy 和 extensions.gallery.serviceUrl 是两套独立机制,前者管“通路”,后者管“目的地”;换镜像源比配代理更稳,但两者配错任意一个,都会导致插件市场不可用。


















