vscode插件市场下载中断主因是网络链路被截断或重置,真正生效的是extensions.gallery.serviceurl与itemurl双配置且末尾必须带斜杠,改http.proxy无效;需彻底退出所有进程后重启,推荐使用https://vscode.cdn.azure.cn/extensiongallery/extensiongallery/镜像源。

VSCode 插件市场下载中断,90% 以上不是插件或 VSCode 自身故障,而是网络链路在某个环节被截断或重置。直接改 extensions.gallery.serviceUrl 并彻底重启进程,比反复清缓存、重装、开代理更有效。
为什么改了 http.proxy 还是卡在 0%
http.proxy 对插件市场页面加载和安装基本无效——VSCode 扩展系统不走这个配置,它用的是 Electron 独立网络栈,只认系统环境变量或硬编码的市场地址。填错格式(比如漏 http:// 前缀)、写成 localhost 或带全角空格,都会静默失效,控制台 Network 面板里根本看不到任何 marketplace 请求。
-
http.proxy只影响极少数后台行为,如自动更新检查、语言包下载 -
http.proxyStrictSSL设为false只解决自签名证书校验失败,不解决“连不上”本身 - 网上流传的
VSCODE_PROXY_SUPPORT环境变量并不存在,VSCode 官方不识别
serviceUrl 配错导致 404 静默重试
只改 extensions.gallery.serviceUrl 不够,必须同时配 extensions.gallery.itemUrl,且两个 URL 末尾都必须带斜杠 /。少一个斜杠,VSCode 收到 404 后不会报错,只会无限“重试中”或卡在空白页。
- 推荐镜像源:
"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"(兼容性最好)或"https://mirrors.tuna.tsinghua.edu.cn/vscode/extensions" - 如果用 open-vsx.org,
itemUrl必须显式写为"https://open-vsx.org/vscode/item",不能省略 - 路径大小写敏感:
extensionGallery正确,extensiongallery会失败
curl 能通但 VSCode 不行?查 TLS 和安全软件
终端执行 curl -v https://marketplace.visualstudio.com 成功,但 VSCode 仍报 net::ERR_CONNECTION_RESET,说明问题出在 TLS 握手后被中间设备(防火墙、WAF、出口网关)主动 RST。VSCode 1.89+ 默认启用 TLS 1.3,但部分老旧网关只认 TLS 1.2。
- 打开 Developer Tools → Network 标签页,点安装,观察失败请求的 Status 和 Timing
- Status 为
0且 stalled 超过 30 秒 → 很可能是 360、腾讯电脑管家等国产安全软件静默丢包 - Status 为
(failed) net::ERR_CONNECTION_TIMED_OUT→ DNS 或 TLS 握手超时,优先换镜像源 - 临时验证:在 settings.json 中加
"http.proxyStrictSSL": false(仅测试,勿长期开启)
手动安装 .vsix 失败的真实原因
离线安装不是拖文件进界面就完事。VSCode 1.77+ 默认启用签名验证和引擎版本强校验,常见失败点不在网络,而在校验链断裂。
- 用解压工具打开 .vsix,确认根目录有
package.json,且其中engines.vscode字段值 ≤ 当前 VSCode 版本(例如你用1.90.0,插件写"^1.92.0"就会被拒) - 文件大小异常小(
- 报
Signature verification failed→ 关闭设置里的extensions.experimental.affinity - 双击无反应 → 系统未关联 .vsix 到 VSCode,改用命令面板执行
Extensions: Install from VSIX
最易被忽略的一点:改完 settings.json 或 product.json 后,只关窗口没用。Windows 必须在任务管理器里杀光所有 Code.exe 和 Code Helper.exe;macOS 要在活动监视器里干掉全部 Code 进程;Linux 执行 pkill -f "code"。否则旧进程还在跑,新配置永远不会生效。











