VSCode无法连接扩展市场主因是直连marketplace.visualstudio.com超时或DNS失败，首选改extensions.gallery.serviceUrl为国内镜像源（如https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/），并彻底退出进程后重启。
VSCode 无法连接到扩展市场，基本就是它连不上 marketplace.visualstudio.com —— 不是你的网络断了，而是这个域名在国内直连极大概率超时、被重置或 DNS 解析失败。改源比调代理更稳、更直接。
为什么改 extensions.gallery.serviceUrl 是首选方案
VSCode 的扩展系统默认硬编码访问微软 CDN，不走系统代理，也不读 http_proxy 环境变量。你开 Clash/Surge，只要没开 TUN 模式或没配对 VSCode，它根本感知不到。而镜像源（比如 https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/）是社区维护的 HTTPS 兼容端点，协议一致、响应快、无需额外证书配置。
- 必须确保 URL 末尾带斜杠
/，否则会返回 404（不是超时，是路径错误） - 不要混用多个镜像：比如同时写
serviceUrl和cacheUrl却指向不同域名，会导致部分扩展列表加载失败 - vscode-cn 镜像（
vscode.cdn.azure.cn）和 Open VSX（open-vsx.org）都可用，但前者兼容性更好，后者部分 Microsoft 官方扩展更新滞后
改完 settings.json 后必须彻底退出 VSCode 进程
只关窗口没用。Windows 要在任务管理器里结束所有 Code.exe 和 Code Helper.exe；macOS 要在活动监视器里杀掉全部 Code 和 Code Helper 进程；Linux 则执行 pkill -f "code"。否则旧进程还在用缓存的市场地址，新配置不会生效。
- 别信“重启编辑器”按钮——它只是重开窗口，后台服务仍在运行
- 右下角托盘图标也要右键退出，否则
code命令行启动的新实例仍会复用旧 host - 首次加载扩展页可能稍慢（要预热镜像缓存），但安装成功率能从不到 30% 提升到 95% 以上
代理配置容易踩的三个坑
如果你坚持用代理而非镜像源，http.proxy 设置极易出错。VSCode 对格式极其敏感，填错一个字符就静默失效。
-
http.proxy必须带协议头，例如"http://127.0.0.1:7890"，不能只写"127.0.0.1:7890" -
http.proxyStrictSSL默认为true，但大多数本地代理（Clash、v2rayN）用的是自签名证书，得设为false，否则 TLS 握手直接失败 -
http.proxyBypassList必须包含"*.visualstudio.com"，否则代理工具可能转发失败或证书校验异常，反而比直连还卡
手动安装 .vsix 时验证文件完整性
离线安装不是万能解药。VSCode 1.77+ 默认启用扩展包签名验证，损坏或来源不明的 .vsix 文件会报 Corrupted ZIP 或 Signature verification failed。
- 用
unzip -t xxx.vsix（Linux/macOS）或 7-Zip 右键“测试压缩包”检查 ZIP 结构是否完整 - 打开
.vsix（本质是 ZIP），确认根目录有extension/package.json，且其中engines.vscode字段值 ≤ 当前 VSCode 版本号（如你用 1.85.3，扩展写"^1.90.0"就装不上） - 企业环境若全程断网，需提前关闭校验：
code --disable-extension-corruption-check启动，但仅限临时调试
最常被忽略的一点：某些国产安全软件（如 360、腾讯电脑管家）会静默拦截对 cdn.azure.cn 这类非主流域名的 HTTPS 请求，不弹窗、不报错，只让请求无声超时。验证方式很简单——把配置好的镜像 URL 粘贴进浏览器地址栏，看能否正常打开 JSON 接口。打不开，问题就在本地终端管控策略，不在 VSCode 配置本身。
