extensions.gallery.serviceurl配错会导致插件市场所有请求静默失败,必须满足三条件:url完整且末尾带/、同步配置cacheurl、大小写严格正确;http.proxy对其无效,需彻底退出进程后重启才生效。

extensions.gallery.serviceUrl 配错就完全失效
VSCode 插件市场所有请求(搜索、安装、更新)都由 extensions.gallery.serviceUrl 控制,但这个字段极其敏感:少一个斜杠、大小写错、路径不完整,都会导致静默失败——界面卡在转圈,Network 面板里看不到任何响应,也不报错。
必须满足这三点才可能生效:
-
serviceUrl值必须是完整 URL,协议+域名+路径,末尾带/,例如:"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/" - 必须同步配置
extensions.gallery.cacheUrl,推荐与serviceUrl完全一致,或明确补上/publishers后缀 - 大小写严格区分:
extensionGallery不能写成extensiongallery或ExtensionGallery
为什么 http.proxy 对插件市场完全没用
很多用户填了 http.proxy 还是转圈,是因为 VSCode 扩展市场页面压根不读这个设置。它走的是 Electron 底层网络栈,和编辑器内其他 HTTP 请求(如语言包下载、自动更新检查)不是同一套逻辑。
如果你坚持用代理:
- 必须从终端启动 VSCode:
code,且 shell 中已导出HTTP_PROXY和HTTPS_PROXY - 双击图标、开始菜单、Dock 启动的 VSCode **完全不继承** shell 环境变量
- 填错格式(比如漏掉
http://前缀、用localhost替代127.0.0.1)会静默忽略,Network 面板里根本看不到请求发出
改完 settings.json 为什么还是没反应
因为 VSCode 的扩展系统只在启动时读一次配置,后台的 Code Helper 进程会缓存旧地址。仅关闭窗口、点“重新加载窗口”或托盘里的“重启”,完全无效。
必须彻底退出所有相关进程:
- Windows:右键任务栏图标 → “退出”;再打开任务管理器,结束全部
Code.exe和Code Helper.exe - macOS:打开“活动监视器”,搜索并强制退出所有
Code和Code Helper进程 - Linux:执行
pkill -f "code"或killall -9 code
不杀干净,新配置永远不加载。
哪些镜像源现在还可靠
截至 2026 年 8 月,vscode.cdn.azure.cn 是目前最稳的选择:它是微软 Azure 中国实际托管的合法镜像,协议兼容、签名验证未改动、主流插件同步及时。别用已失效的 vscode.bj.bcebos.com(百度 BOS 镜像近年不稳定)。
如果公司内网策略限制访问 vscode.cdn.azure.cn,可临时换阿里云 OSS 镜像:
"extensions.gallery.serviceUrl": "https://vscode-extensions.oss-cn-hangzhou.aliyuncs.com/extensionGallery/extensionGallery/"
注意:open-vsx.org 上部分 Microsoft 官方扩展版本滞后,安装时可能报 Signature verification failed;清华镜像需改 product.json,但 VSCode 升级后该文件会被覆盖,维护成本高。











