必须同时配置extensions.gallery.serviceUrl和cacheUrl且同域、路径正确、结尾不带/,并彻底退出VSCode进程后重启,否则配置静默失效;serviceUrl控制市场请求,cacheUrl专用于publisher列表,缺一不可。

直接换 extensions.gallery.serviceUrl 和 extensions.gallery.cacheUrl 就能解决插件下载慢或超时问题,不是“试试看”,而是必须配对生效——只改一个、路径带斜杠、没彻底退出进程,都会导致配置静默失效。
为什么改了 serviceUrl 还是卡在 pending
VSCode 插件市场默认请求 marketplace.visualstudio.com,国内直连常卡在 TLS 握手或 DNS 解析阶段,Network 面板里能看到一堆 pending 状态的请求。但仅改 extensions.gallery.serviceUrl 不够,1.83+ 版本起必须同时配置 extensions.gallery.cacheUrl,否则整个配置被忽略。
-
serviceUrl结尾不能带/,比如https://vscode.cdn.azure.cn/api/gallery/会拼出错误路径导致 404 -
cacheUrl必须和serviceUrl同域,且路径为/api/gallery/cache,写成其他路径(如/cache)会被直接跳过 - 配置必须写在用户级
settings.json(不是工作区),路径分别是:
Windows:%APPDATA%\Code\User\settings.json
macOS:~/Library/Application Support/Code/User/settings.json
Linux:~/.config/Code/User/settings.json
settings.json 正确配置示例
打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),输入并运行 Preferences: Open Settings (JSON),在已有 JSON 对象内添加以下两行(注意逗号分隔):
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/api/gallery", "extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/api/gallery/cache"
这个镜像由微软 Azure 官方运营,SHA256 与源站一致,比第三方镜像(如已失效的 vscode.bj.bcebos.com)更稳定。如果公司网络拦截非标准域名,可临时切换阿里云源:"extensions.gallery.serviceUrl": "https://vscode-extensions.oss-cn-hangzhou.aliyuncs.com/extensionGallery/extensionGallery/"
但注意:阿里云源不提供 cacheUrl 兼容路径,此时需删掉 cacheUrl 行,否则反而失效。
改完必须彻底退出 VSCode 进程
保存 settings.json 后,VSCode 不会热重载这两项配置,必须完全退出再启动:
- Windows:右键任务栏图标 → 「退出」(不是关闭窗口)
- macOS:打开 Activity Monitor,搜索
Code,强制退出所有相关进程 - Linux:终端执行
pkill -f 'code'
若仍加载失败,检查是否被本地安全软件(如火绒、360)拦截 HTTPS 流量,或 Clash/Surge 开启了 TUN 模式——它们会劫持 socket,导致对 vscode.cdn.azure.cn 的请求无声失败。
命令行安装(code --install-extension)还是超时怎么办
命令行环境不继承 settings.json 配置,需靠环境变量兜底:
- 临时生效(当前终端):
VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn code --install-extension esbenp.prettier-vscode - 若仍报
ETIMEDOUT或卡在pending,大概率是代理工具(Clash/Surge)正在后台运行但未全局,显式禁用:code --proxy-settings=off --install-extension esbenp.prettier-vscode - 注意:像
ms-python.python这类插件会额外拉取语言服务器二进制包,这部分不走 gallery 协议,镜像对其无效——只能离线下载或配代理
最常被忽略的一点:插件市场加载失败时,很多人反复清缓存、重装插件,却没意识到根本原因只是 cacheUrl 缺失或进程没彻底退出。


















