必须彻底退出VSCode并杀掉所有Code和Code Helper进程,否则新配置不生效;需同步配置serviceUrl与cacheUrl,且URL必须带完整协议、路径正确、末尾有/、大小写敏感,http.proxy对扩展市场无效。

extensions.gallery.serviceUrl 配了但没反应?先杀光 Code Helper 进程
改完 settings.json 里 extensions.gallery.serviceUrl 却还是转圈、空白、报 Unable to connect to the extension gallery,大概率是旧进程还在缓存旧地址。VSCode 的扩展市场模块不热更新,只在启动时读一次配置。
- Windows:右键任务栏图标 → “退出”;再打开任务管理器,结束所有
Code.exe和Code Helper.exe - macOS:打开“活动监视器”,搜索
Code和Code Helper,全部强制退出 - Linux:终端执行
pkill -f "code"或killall -9 code - 别信“重新加载窗口”或托盘里的“重启”——这些操作后台服务仍在跑,新配置根本没加载
serviceUrl 和 cacheUrl 必须配齐,且路径不能错
extensions.gallery.serviceUrl 是主入口,但 VSCode 启动时还会单独请求 publisher 列表,走的是 cacheUrl。漏配或路径错,扩展页就卡在“加载中”或直接空白。
-
serviceUrl必须带完整协议+路径,末尾必须有/,例如:"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/" -
cacheUrl推荐与serviceUrl完全一致,或明确补上/publishers,例如:"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/publishers" - 大小写敏感:
extensionGallery不能写成extensiongallery或ExtensionGallery - 别混用镜像源:比如
serviceUrl指向vscode.cdn.azure.cn,cacheUrl指向open-vsx.org,会导致部分请求 404 或签名校验失败
http.proxy 对插件市场无效,别白填
http.proxy 设置对扩展市场页面(搜索、安装、更新)完全不起作用。它只影响语言包下载、自动更新检查等次要请求。填了却还转圈,不是代理没开,而是你根本没配对地方。
- VSCode 扩展市场走 Electron 底层网络栈,不读
http.proxy,也不继承系统环境变量HTTP_PROXY/HTTPS_PROXY - 如果坚持用代理,必须从终端启动:
code,且确保 shell 中已设好HTTP_PROXY和HTTPS_PROXY - 双击图标、开始菜单启动的 VSCode,压根看不到 shell 里的代理变量
- 填错格式(如漏
http://前缀、用localhost替代127.0.0.1)会静默忽略,Network 面板里都看不到请求发出
镜像源选哪个?vscode.cdn.azure.cn 最省心
微软 Azure 中国托管的镜像,协议兼容、签名验证逻辑未改动、主流插件同步及时。相比 open-vsx.org 或清华源,它不需要额外证书配置,直连即可,也不依赖本地是否开了代理。
- 推荐值:
"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/" - 备用选项(如公司防火墙封了 azure.cn):
"https://vscode-extensions.oss-cn-hangzhou.aliyuncs.com/extensionGallery/extensionGallery/" - 清华源需改
product.json,升级后会被覆盖,维护成本高;open-vsx.org 需手动处理签名兼容性,部分插件可能无法安装 - 别用
marketplace.visualstudio.com开头再替换——这个地址已逐步停用,且国内 DNS 解析常失败
真正卡住的点从来不是“怎么填”,而是进程没杀干净、cacheUrl 漏了、路径少了个斜杠,或者误以为 http.proxy 能管市场页面。这些细节一错,整个配置就静默失效。


















