直接修改 extensions.gallery.serviceUrl 可解决90%的VSCode插件市场“转圈”“无法连接”问题,因其绕过无效的http.proxy设置,直连国内镜像源如https://vscode.cdn.azure.cn/,需彻底退出所有进程后重启生效。

直接改 extensions.gallery.serviceUrl 比配代理快、稳、不依赖本地工具,90% 的“转圈”“无法连接”问题靠这一步就能解决。
为什么改了 http.proxy 还是没用
VSCode 插件市场页面(搜索、安装、更新)根本不读 http.proxy 设置项。它走 Electron 底层网络栈,只认系统环境变量或硬编码的 service URL。你填了 "http.proxy": "http://127.0.0.1:7890" 却卡在加载中,大概率是白配。
-
http.proxy只影响语言包下载、自动更新检查等次要请求,对主市场页面无效 - 双击图标或从开始菜单启动 VSCode 时,
HTTP_PROXY/HTTPS_PROXY环境变量通常不生效 - 漏写
http://或https://协议头(比如只写127.0.0.1:7890)会导致静默忽略,Network 面板看不到任何请求
怎么正确配置国内镜像源
微软官方虽未提供中国区入口,但 https://vscode.cdn.azure.cn 是 Azure 中国实际托管的合法镜像,协议兼容、更新及时,直连即可。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入并选择Preferences: Open Settings (JSON) - 添加以下三行(注意逗号分隔、每行末尾必须有
/):"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/",<br>"extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/",<br>"extensions.gallery.itemUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"
- 保存后,必须彻底退出所有 VSCode 进程:Windows 右键任务栏图标 → “退出”,再进任务管理器杀掉所有
Code.exe和Code Helper.exe;macOS 用活动监视器杀掉全部Code和Code Helper;Linux 执行killall -9 code - 重启后再打开扩展面板,首次加载稍慢属正常(预热镜像缓存)
备选镜像与常见踩坑点
如果 vscode.cdn.azure.cn 不可用,可换阿里云或 Open VSX 镜像,但要注意兼容性差异。
- 阿里云 OSS 镜像(杭州节点):
"extensions.gallery.serviceUrl": "https://vscode-extensions.oss-cn-hangzhou.aliyuncs.com/extensionGallery/extensionGallery/" - Open VSX(开源社区源):
"extensions.gallery.serviceUrl": "https://open-vsx.org/vscode/gallery"—— 但 Microsoft 官方扩展(如ms-python.python)可能版本滞后或签名缺失,安装时报Signature verification failed - URL 少一个
/会静默返回 404,界面卡住不报错;大小写敏感,extensionGallery不能写成extensiongallery - 某些国产杀毒软件(如 360、腾讯电脑管家)会静默拦截对
cdn.azure.cn的 HTTPS 请求,不弹窗、不报错,只让请求无声超时
最常被忽略的是进程没杀干净——右下角托盘图标还在、后台 Code Helper 进程仍在运行,新配置就永远不会加载。别信“重新加载窗口”,那只是刷新前端,不是重置扩展通信链路。


















