VSCode插件市场无法连接的根本原因是死守不可用的marketplace.visualstudio.com，应配置extensions.gallery.serviceUrl为国内镜像源（如https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/），并彻底退出所有Code及Code Helper进程后重启，否则新配置不生效。
extensions.gallery.serviceUrl 配置没改，VSCode 就卡死在 marketplace.visualstudio.com
90% 的插件加载失败，根本不是插件问题，而是 VSCode 死守 marketplace.visualstudio.com 这个域名，而它在国内直连极不稳定：DNS 污染、TLS 握手被重置、出口限速都会导致“转圈”“空白页”“XHR failed”“Unable to fetch extensions”。
VSCode 不会 fallback 到备用源，必须手动指定国内镜像：
- 打开命令面板
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Preferences: Open Settings (JSON) - 在
settings.json中添加一行（注意逗号分隔，末尾必须带/）："extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/" - 保存后，**必须彻底退出 VSCode 进程**：Windows 右键任务栏图标 → “退出”；macOS 在 Activity Monitor 杀掉所有
Code和Code Helper进程；Linux 执行killall -9 code - 重启后再打开扩展面板，首次加载稍慢，但后续搜索/安装成功率明显提升
备选镜像（如 azure.cn 不可用）："extensions.gallery.serviceUrl": "https://vscode-extensions.oss-cn-hangzhou.aliyuncs.com/extensionGallery/extensionGallery/"
或开源社区源："extensions.gallery.serviceUrl": "https://open-vsx.org/vscode/gallery"
http.proxy 配置错配，请求卡在 pending 状态却无报错
很多用户开了 Clash/Surge，但没开「系统代理」，结果 VSCode 读到一个指向 127.0.0.1:7890 的 http.proxy 设置，而代理实际没监听 HTTP 端口——请求就静默卡在 pending，表现为“加载中…”不动，控制台也看不到错误。
解决方法很简单：
- 打开设置（
Ctrl+,），搜索proxy - 找到
HTTP: Proxy项，如果值是类似http://127.0.0.1:7890或127.0.0.1:1080，且你当前没运行对应代理服务，直接清空该字段，或设为none - 顺手删掉
"http.proxyStrictSSL": false（它会削弱证书校验，仅调试用，不该长期开着） - 确认无残留后重启 VSCode
注意：VSCODE_PROXY_SUPPORT 这个环境变量根本不存在，是网上误传；真正生效的是系统级 HTTP_PROXY/HTTPS_PROXY，但仅当用终端执行 code 启动时才继承——双击图标启动的 VS Code 压根读不到 shell 里的 export。
.vsix 手动安装失败，多半是版本不兼容或 TLS 校验过严
双击 .vsix 文件无反应，或命令行执行 code --install-extension xxx.vsix 报 Extension is not compatible with Code，基本就是版本不匹配。
验证方式：
- 用 ZIP 工具打开 .vsix，检查根目录下
extension/package.json中的engines.vscode字段，比如值为"^1.90.0"，而你当前 VS Code 是1.85.2，就必然失败 - VS Code 1.89+ 默认启用 TLS 1.3，某些老旧 .vsix 签名只适配 TLS 1.2，也会静默拒绝
- 别信“重命名后缀为 zip 再改
package.json”——签名校验通不过，安装仍会中止
正确做法：去插件官网或 GitHub Release 页面，下载明确标注支持你当前 VS Code 版本的 .vsix；或者升级 VS Code 至推荐版本。
安全软件静默拦截 cdn.azure.cn 等非标准 HTTPS 域名
某些国产杀毒软件（如 360、腾讯电脑管家）或企业终端管控工具，会静默拦截 VSCode 对 cdn.azure.cn 等非微软官方域名的 HTTPS 请求——不报错、不弹窗，只让请求无声超时。
验证方式非常简单：
- 在浏览器里直接打开
https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/ - 能进，说明网络通路没问题；打不开，才是 DNS 或防火墙问题
- 如果浏览器能进、VSCode 却不行，大概率是安全软件在后台拦截
临时绕过：换用 open-vsx.org 镜像源；长期方案：在安全软件白名单中添加 VSCode 进程，或关闭其“HTTPS 流量检测”类功能。
