根本原因是网络层阻断导致无法访问 marketplace.visualstudio.com,解决方案包括配置代理(需启用系统代理并设 http.proxyStrictSSL 为 false)、切换清华等国内镜像源(修改 product.json 中 extensionsGallery 地址)、手动下载 VSIX 安装(推荐 open-vsx.org),以及排查 DNS 劫持或杀毒软件拦截。

VSCode插件商店连不上或下载卡在 0% 怎么办
根本原因不是插件本身问题,而是 VSCode 默认通过 marketplace.visualstudio.com 访问微软官方源,国内直连经常超时、被重置或返回空响应。你看到的「正在安装」「等待中」「Failed to fetch」基本都源于网络层阻断,而非本地配置错误。
实操上优先检查是否已启用代理——很多用户开了系统代理但 VSCode 没继承,或者用了 HTTP 代理却没配 HTTPS 支持。
- 打开 VSCode 设置(
Ctrl+,),搜索proxy,确认http.proxy已填入正确地址(如http://127.0.0.1:7890) - 务必勾选
http.proxyStrictSSL设为false(否则自签名代理证书会直接拒绝连接) - 如果用的是 Clash、Surge 等工具,确保其「System Proxy」已开启,且 VSCode 是从终端启动(
code .),避免 GUI 方式绕过系统代理
不用代理也能加速:换国内镜像源(支持离线安装)
微软官方不提供镜像,但社区维护了可用的兼容源,原理是反向代理 + 缓存插件包(VSIX),响应快且稳定。注意:这些镜像不修改插件逻辑,仅替换下载地址,安全性取决于镜像运营方,推荐使用 GitHub 上 star 数高、更新频繁的项目。
生效方式是修改 VSCode 内部请求头或覆盖 marketplace 域名解析,最稳妥的是改 product.json 文件(路径因系统而异):
- Windows:
%USERPROFILE%\AppData\Local\Programs\Microsoft VS Code\resources\app\product.json - macOS:
/Applications/Visual Studio Code.app/Contents/Resources/app/product.json - Linux:
/usr/share/code/resources/app/product.json
找到 "extensionsGallery" 字段,把 "serviceUrl" 和 "itemUrl" 改成镜像地址,例如清华源:
"extensionsGallery": {
"serviceUrl": "https://mirrors.tuna.tsinghua.edu.cn/vscode/extensions",
"itemUrl": "https://mirrors.tuna.tsinghua.edu.cn/vscode/item",
"controlUrl": "",
"recommendationsUrl": "https://mirrors.tuna.tsinghua.edu.cn/vscode/recomm"
}
改完保存,重启 VSCode。注意:升级 VSCode 后该文件会被覆盖,需重新修改。
手动下载 VSIX 安装:绕过商店所有限制
当代理不稳、镜像失效或企业环境禁外网时,这是最可靠的兜底方案。关键不是“怎么下”,而是“怎么找正版、可验证的 VSIX”。
- 去插件官网页(如
https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)右键「在新标签页打开」链接里的Download Extension按钮,实际会跳转到一个.vsix直链 —— 但这个链常被限速;更稳的方式是用第三方索引站,比如https://vscode-ext.gq/或https://open-vsx.org/(后者是 Eclipse 基金会托管的开源替代源,支持大部分主流插件) - 下载后,在 VSCode 中按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选中文件即可,不走网络校验 - 注意:
open-vsx.org上的插件 ID 可能和 Marketplace 不一致(如 Prettier 是esbenp.prettier-vscodevsesbenp.prettier),安装前核对 ID 避免装错
为什么改了设置还是走原域名?检查 DNS 和 hosts 干扰
有些网络环境(尤其公司内网、校园网)会劫持 DNS 或强制写入 hosts,导致即使设置了代理或镜像,VSCode 仍尝试直连 marketplace.visualstudio.com 并失败。
快速验证方法:在命令行运行 nslookup marketplace.visualstudio.com,看返回 IP 是否为微软官方段(如 20.42.128.0/17)。如果不是,说明 DNS 被污染。
- 临时解决:在
hosts文件末尾加一行20.42.130.15 marketplace.visualstudio.com(IP 可用ping marketplace.visualstudio.com获取最新) - 更彻底:在 VSCode 设置里关闭
telemetry.telemetryLevel(设为off),避免后台静默请求触发 DNS 劫持 - 极少数情况:杀毒软件(如 360、腾讯电脑管家)会拦截 VSCode 的 HTTPS 请求,可临时退出再试
镜像源和代理只是表象,真正卡住的往往是 DNS 解析或 TLS 握手环节——这点最容易被忽略,也最难排查。











