根本原因是vscode默认连接微软cdn(marketplace.visualstudio.com)在国内网络不稳定,导致超时或连接重置;应优先配置国内镜像源如"https://vscode.cdn.azure.cn/extensiongallery/extensiongallery/"并彻底重启vscode进程。

VSCode插件商店卡在“加载中”或显示“无法连接到扩展市场”
根本原因不是 VSCode 坏了,而是它默认走微软官方 CDN(marketplace.visualstudio.com),在国内直连经常超时或被重置。你看到的转圈、空白页、弹窗报错 Unable to fetch extensions,基本都指向网络链路不通。
实操建议优先改用国内镜像源,而不是反复重启/重装/清缓存——那些对网络层问题无效。
- 打开 VSCode,按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入并选择Preferences: Open Settings (JSON) - 在打开的
settings.json中添加这一行(注意逗号位置):"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery"
- 保存后,**必须完全退出 VSCode 进程**(右键任务栏图标 → 退出,或 macOS 上 Activity Monitor 杀掉所有
Code进程),再重新启动
安装扩展时提示“Download failed: connect ETIMEDOUT”或“getaddrinfo ENOTFOUND”
这是 Node.js 底层发起 HTTP 请求失败的典型错误,说明 VSCode 的扩展下载模块根本没连上远程服务器。和本地代理设置、系统 hosts、防火墙都可能有关,但最常见的是 DNS 解析失败或 TLS 握手卡住。
别急着开全局代理——VSCode 不继承系统代理,也不读取终端里的 http_proxy 环境变量。
- 确认你已配置了上面的
extensions.gallery.serviceUrl,且值末尾有斜杠/(少这个会 404) - 如果公司网络有严格出口策略,可尝试换用阿里云镜像:
"extensions.gallery.serviceUrl": "https://vscode-extensions.oss-cn-hangzhou.aliyuncs.com/extensionGallery/extensionGallery"
- 禁用所有代理软件(Clash、Surge、Shadowrocket)的「TUN 模式」或「系统代理」开关,它们会劫持 VSCode 的 socket 连接导致握手异常
修改后仍无法加载,检查是否被本地安全软件拦截
某些国产杀毒软件(如 360、腾讯电脑管家)或企业级终端管控工具,会静默拦截 VSCode 对非标准域名(如 cdn.azure.cn)的 HTTPS 请求,不报错、不弹窗,只让请求无声超时。
这不是配置问题,是运行时拦截。验证方式很简单:在浏览器里直接打开你设的 serviceUrl 地址,看能否正常返回 JSON 数据。
- 如果浏览器也打不开,说明是网络策略或 DNS 问题;能打开,但 VSCode 依然失败 → 大概率是安全软件拦截
- 临时关闭杀软的“网页防护”“HTTPS 扫描”模块,再试一次 VSCode 扩展市场
- 若必须长期开启,把
Code.exe(Windows)或Visual Studio Code.app(macOS)加进白名单,而不是放行整个端口或域名
Mac 上启用自动代理后插件市场失效
macOS 系统级代理(Wi-Fi 设置里的“配置代理”)会影响 VSCode,但它的行为不稳定:有时生效,有时只影响部分请求,导致扩展列表能刷出来,但点击安装时下载失败。
VSCode 官方明确不推荐依赖系统代理,尤其 PAC 脚本场景下,Node.js 的 https.Agent 解析容易出错。
- 进入 macOS「系统设置 → 网络 → Wi-Fi → 详细信息 → 代理」,关闭所有代理选项(包括「自动代理配置」)
- 如需代理访问外网,改用 VSCode 内置代理配置:
"http.proxy": "http://127.0.0.1:7890",<br>"http.proxyStrictSSL": false
(注意:仅当确定代理服务稳定支持 HTTPS 隧道时才开) - 不要同时开启系统代理 + VSCode 代理配置,冲突概率极高
真正卡住人的地方,往往不是 URL 写错,而是进程没彻底重启、安全软件没识别到 VSCode、或者镜像地址少了个斜杠。这些细节不报错,只让你一直对着转圈发呆。











