VSCode扩展安装缓慢的根本原因是marketplace.visualstudio.com在国内被DNS污染或连接超时,推荐切换为Open VSX镜像源并彻底退出重开;手动安装.vsix需校验完整性、避开同步目录和杀软拦截;代理需在settings.json中正确配置且禁用SSL校验;清理CachedExtensionVSIXs缓存可解决假死。

VSCode 扩展安装缓慢,根本原因不是“网速慢”,而是它默认直连微软的 marketplace.visualstudio.com —— 这个域名在国内常被 DNS 污染、连接超时或重定向失败,尤其在 VSCode 1.80+ 版本后更明显。换镜像或手动装 .vsix 是最直接有效的解法,不是权宜之计,而是生产环境标配。
换 Open VSX 镜像源(推荐国内用户首选)
Open VSX 是开源社区维护的兼容市场,不需登录、无墙、CDN 稳定,95% 的常用扩展(如 ESLint、Prettier、GitLens)都已同步,且更新延迟通常不超过 48 小时。
- 打开
settings.json(Ctrl+, → 右下角点击“打开设置 (JSON)”) - 粘贴以下配置,**完全替换原有
extensions.gallery部分**:{ "extensions.gallery": { "serviceUrl": "https://open-vsx.org/vscode/gallery", "itemUrl": "https://open-vsx.org/vscode/item" } } -
必须彻底退出 VSCode:右键任务栏图标 → “退出”,或 macOS 上用
Cmd+Q;仅关闭窗口不生效 - 重开后搜索扩展,速度会从“转圈 2 分钟”变为“秒出结果”
⚠️ 注意:C/C++、Python 等 Microsoft 官方扩展在 Open VSX 上版本略旧,但功能完整;若某扩展搜不到,可去 https://open-vsx.org 网页端搜索,点“Download”拿到 .vsix 链接再本地安装。
手动安装 .vsix 文件(离线/内网/调试专用)
.vsix 就是 ZIP 包,没签名也能装,但 VSCode 1.77+ 默认校验签名。遇到 Corrupted ZIP 或 Signature verification failed 错误,别急着关验证,先确认文件本身是否损坏。
- 下载后用命令检查完整性:
unzip -t your-extension-1.2.3.vsix(Linux/macOS)或用 7-Zip 右键“测试压缩包”(Windows) - 安装方式二选一:
– 图形界面:Ctrl+Shift+P → 输入Extensions: Install from VSIX→ 选文件
– 命令行:code --install-extension /path/to/your-extension-1.2.3.vsix - 装完不生效?看扩展是否要求重启:部分插件(如
Remote - SSH)需完全退出 VSCode 再打开才加载
⚠️ 容易踩的坑:杀毒软件(尤其是 Windows Defender 或腾讯电脑管家)常在后台拦截 .vsix 解压过程,临时禁用“实时防护”再试;另外,不要把 .vsix 放在 OneDrive 或 iCloud 同步目录里,文件锁会导致安装失败。
代理配置不是万能的,但必须配对
很多人开了系统代理,却忘了 VSCode 不继承系统设置。如果公司网络强制走代理,只改系统环境变量 HTTP_PROXY 是无效的。
- 在
settings.json中加这两行:"http.proxy": "http://127.0.0.1:10809", "http.proxyStrictSSL": false
-
http.proxyStrictSSL必须设为false,否则自建代理或中间人证书会触发NETWORK_ERROR - 如果代理是 socks5(比如 Clash),VSCode 原生不支持,得用
privoxy或cntlm转成 http 代理再填
别信“代理开了就行”的说法——VSCode 的代理只作用于扩展市场和内置终端,不影响你项目里 npm install,那还得单独配 npm 镜像(npm config set registry https://registry.npmmirror.com)。
清理缓存比重装更管用
很多“安装卡住”其实是旧缓存损坏导致的假死。VSCode 会把下载中的 .vsix 存在 CachedExtensionVSIXs 目录,断网重连后不会自动续传,而是无限等待。
- 关闭 VSCode 后执行:
Windows:del /q "%USERPROFILE%\.vscode\CachedExtensionVSIXs\*"
macOS/Linux:rm -rf ~/.vscode/CachedExtensionVSIXs - 顺手清扩展目录残留(非必须,但建议):
rm -rf ~/.vscode/extensions/*(注意星号别漏) - 重启 VSCode,首次搜索会稍慢(重建索引),之后就恢复正常
真正关键的点往往藏在细节里:换镜像必须全退重开,.vsix 要验包再装,代理要配对且关 SSL 校验,缓存路径名带 CachedExtensionVSIXs 而不是 cache —— 这些小写字母拼错一个,就白忙十分钟。










