讲师中心 微信公众号
AI工具推荐 视频效率加速

如何解决VSCode插件商店一直转圈加载不出来或扩展下载失败的网络问题

老墨大大_4385

老墨大大_4385

发布时间:2026-03-31 15:28:03

|

1944人浏览过

|

来源于php中文网

原创

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

如何解决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 请求,不报错、不弹窗,只让请求无声超时。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

这不是配置问题,是运行时拦截。验证方式很简单:在浏览器里直接打开你设的 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、或者镜像地址少了个斜杠。这些细节不报错,只让你一直对着转圈发呆。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2155

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3302

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1116

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3779

2025.09.10

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

4416

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1355

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1758

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

9963

2023.08.17

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn