VSCode无法连接插件商店的根本原因是默认访问marketplace.visualstudio.com或open-vsx.org在国内网络下DNS解析失败、TLS握手重置或空响应,应配置extensions.gallery.serviceUrl与cacheUrl为国内镜像源(如https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/和https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/publishers),并彻底退出所有Code及Code Helper进程后重启。

VSCode无法连接插件商店,根本不是插件或编辑器坏了,而是它死守 marketplace.visualstudio.com 或已不稳定的 open-vsx.org,在国内网络环境下大概率 DNS 解析失败、TLS 握手被重置、或返回空响应。换镜像源是最快、最稳、副作用最小的解法——但配错 URL、漏掉关键字段、没彻底退出进程,都会让配置完全失效。
怎么配 extensions.gallery.serviceUrl 才真正生效
这个配置是 VSCode 扩展系统的“主开关”,改了它,所有市场请求(搜索、安装、更新)都会走新地址。但必须严格满足三个条件:
-
serviceUrl必须带完整路径,末尾要有/,例如"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"—— 少了斜杠会返回 404,界面静默卡住 - 不能只配
serviceUrl,还得同步配cacheUrl,否则 publisher 列表加载失败,扩展页空白或转圈 - URL 必须是协议+域名+路径的完整形式,不能只写
https://vscode.cdn.azure.cn,也不能拼错成extensiongallery(大小写敏感)
为什么 vscode.cdn.azure.cn 是目前最稳妥的选择
它不是代理中转,而是微软 Azure 中国实际托管的合法镜像,协议完全兼容、签名验证逻辑未改动、主流插件(包括 ms-python.python、ms-vscode.cpptools)同步及时。相比 open-vsx.org:
-
open-vsx.org上部分 Microsoft 官方扩展版本滞后,安装时可能报Signature verification failed -
vscode.cdn.azure.cn不需要额外证书配置,直连即可,也不依赖你本地是否开了代理 - 阿里云 OSS 镜像(如
vscode-ext.oss-cn-shenzhen.aliyuncs.com)也可用,但部分用户反馈偶发 CDN 缓存未及时刷新
改完 settings.json 为什么还是没反应
因为 VSCode 后台服务进程(Code Helper)还在跑,它缓存着旧的市场地址,新配置根本没加载。必须彻底退出:
- Windows:右键任务栏图标 → “退出”;再打开任务管理器,结束所有
Code.exe和Code Helper.exe - macOS:打开“活动监视器”,搜索并强制退出全部
Code和Code Helper进程 - Linux:执行
pkill -f "code"或killall -9 code - 别信“重新加载窗口”或右下角托盘“重启”——这些操作后台服务仍在运行
手动安装 .vsix 失败时先查什么
双击安装或用 code --install-extension 命令失败,常见原因和 marketplace 连接无关,而是本地环境不匹配:
- 检查
.vsix根目录下extension/package.json的engines.vscode字段,比如值为"^1.90.0",而你当前 VS Code 是1.85.2,必然报错Extension is not compatible with Code - VS Code 1.89+ 默认启用 TLS 1.3,某些老旧
.vsix签名只适配 TLS 1.2,也会静默拒绝 - 别尝试解压后改
package.json再重打包——签名校验通不过,安装仍会中止
最常被忽略的一点:镜像源首次加载确实会慢几秒(要预热 CDN 缓存),但这不是失败信号;如果等了 10 秒以上仍空白或报错,优先检查 cacheUrl 路径是否漏了 /publishers,以及是否真杀干净了所有后台进程。











