vscode插件下载慢本质是直连境外服务器导致高延迟或超时,必须更换镜像源;修改settings.json中extensions.gallery.serviceurl为https://vscode.cdn.azure.cn/_apis/public/gallery并重启即可秒开市场。
立即进入“夸克ai手把手教你,操作像呼吸一样简单!☜☜☜☜☜点击进入”;

VSCode插件下载慢,本质是默认连境外服务器 vsextensions.blob.core.windows.net 和 marketplace.visualstudio.com,国内直连大概率高延迟、超时或被限速。换镜像源是最直接有效的解法,不是“试试看”,而是必须做。
怎么改 extensions.gallery.serviceUrl 镜像源
这是最常用、最稳定的加速方式,改完重启 VSCode 即可生效,扩展市场秒开、安装不卡。
- 打开用户设置文件:
%APPDATA%\Code\User\settings.json(Windows)、~/Library/Application Support/Code/User/settings.json(macOS)或~/.config/Code/User/settings.json(Linux) - 添加两行配置(注意逗号分隔,且必须和已有配置在同一 JSON 对象内):
{
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery",
"extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery/publishers"
}
其中 vscode.cdn.azure.cn 是社区维护的 vscode-cn 镜像,更新及时、兼容性好,比阿里云/清华等第三方镜像更贴近原协议。别用已失效的 vscode.bj.bcebos.com(百度 BOS 镜像近年已不稳定)。
为什么 code --install-extension 还是失败
命令行安装失败,常见于环境变量未生效或镜像未覆盖全部请求路径,尤其在 CI/CD 或远程开发场景下容易踩坑。
- 确保设置了环境变量再运行命令:
VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn code --install-extension esbenp.prettier-vscode - 如果仍报
connect ETIMEDOUT或卡在 pending,说明 VSCode 进程继承了系统代理设置(比如 Clash 正在运行但未全局),此时需临时关闭代理工具,或显式禁用:code --proxy-settings=off --install-extension ... - 某些插件(如
ms-python.python)会额外请求语言服务器二进制包,这部分不走 gallery 协议,镜像源对其无效——只能靠代理或离线下载
手动下载 .vsix 文件后安装失败怎么办
双击没反应、code --install-extension xxx.vsix 报错,问题往往不在网络,而在文件本身或版本兼容性。
- 检查
.vsix是否完整:用 ZIP 工具打开,确认根目录有extension/package.json - 查看
package.json中的engines.vscode字段,例如"^1.90.0"表示最低需要 VSCode 1.90;你当前版本是1.85.2就无法安装 - 签名验证失败(
Signature verification failed)通常因文件下载中断导致损坏,建议用浏览器重下,或校验 SHA256 值(镜像站一般提供) - Linux/macOS 下注意文件权限:如果
.vsix来自非可信来源,系统可能阻止执行,先chmod +x再试
镜像源不是万能的,这些情况它帮不上忙
换源解决的是 marketplace 主流程,但插件生态里还有几类请求完全绕过它:
- 插件自身在激活时动态下载的依赖(比如
rust-analyzer的二进制、prettier的 node_modules)——这类必须靠系统级代理或本地缓存(如pnpm store) - GitHub Releases 直链(如
GitLens更新内置 CLI)——域名仍是github.com,镜像源不生效 - 企业内网禁用了
vscode.cdn.azure.cn,而你又没权限改 DNS 或 hosts ——这时只能离线下载 + IT 部门白名单放行
真正卡住的时候,先用开发者工具 Network 面板看清楚到底哪个域名在 pending,别一上来就改 settings.json。











