直接换镜像源+手动装.vsix是唯一可靠解法,因VSCode插件市场超时源于TLS握手、DNS或CDN回源等不可控环节,改timeout无效;推荐Open VSX镜像源并彻底退出VSCode生效,缺失插件需手动安装.vsix文件。

直接换镜像源 + 手动装 .vsix 是唯一可靠解法,别指望调 timeout 参数能救活 marketplace 直连。
为什么改 connectTimeout 没用
VSCode 插件市场下载超时不是 FTP/SFTP 那种可配 connectTimeout 的协议层问题,而是 HTTP 请求卡在 TLS 握手、DNS 解析或 CDN 回源阶段。这些环节不响应客户端 timeout 设置,界面只显示 “Downloading…” 且无错误提示。
-
extensions.gallery.serviceUrl默认指向https://marketplace.visualstudio.com/...,该域名在国内多数情况下返回 404 或静默超时 - 即使服务器能 curl 通,也可能因 TLS 1.3 兼容性差、SNI 被拦截、或中间设备重置连接导致请求失败
- 大体积插件(如
ms-python.python、ms-vscode.cpptools)会触发多段下载(.vsix + language server 二进制),任一环节失败即卡死
换 Open VSX 镜像源(推荐国内用户)
Open VSX 是开源社区维护的兼容市场,CDN 稳定、无需登录、无墙,95% 常用插件已同步,更新延迟通常 ≤48 小时。
- 打开
settings.json(Ctrl+, → 右下角“打开设置 (JSON)”) - 完整替换
extensions.gallery部分,注意末尾斜杠必须存在:
{
"extensions.gallery": {
"serviceUrl": "https://open-vsx.org/vscode/gallery/",
"itemUrl": "https://open-vsx.org/vscode/item/"
}
}
- 必须彻底退出 VSCode(Windows 任务栏右键 →「退出」;macOS 按 Cmd+Q),否则配置不生效
- 重启后搜索插件,若仍找不到(如 Microsoft 官方 TypeScript 插件),说明 Open VSX 未收录,需手动安装
手动安装 .vsix 文件(绕过所有网络链路)
适用于 Open VSX 缺失插件、企业内网无外网权限、或下载中途断连反复失败的场景。
- 去
https://open-vsx.org网页搜索插件名,点击 “Download” 获取.vsix直链 - 或从微软市场页面右键复制 URL,把
https://marketplace.visualstudio.com/items?itemName=xxx改成https://marketplace.visualstudio.com/_apis/public/gallery/publishers/xxx/vsextensions/xxx/version/vspackage(需替换 publisher、extension ID、version) - 在 VSCode 中按 Ctrl+Shift+P → 输入
Extensions: Install from VSIX→ 选择本地文件 - 装完后检查插件详情页的 ID 是否匹配(如
ms-python.python),避免装错第三方仿冒包
容易被忽略的关键点
换源后不删 CachedExtensionVSIXs 缓存目录,VSCode 仍会尝试从旧源拉包;手动装 .vsix 若放在 OneDrive / iCloud 同步目录下,可能被杀软拦截或文件锁住导致安装失败;插件 ID 必须全小写、带点号分隔,大小写错一位(如 MS-Python.Python)就会报 “Extension not found”。











