VSCode插件加载失败主因是无法连接扩展市场，需修改settings.json中的extensions.gallery.serviceUrl为国内镜像源（如https://vscode.cdn.azure.cn/.../），并彻底退出进程后重启；同时清除错误http.proxy配置、排查安全软件拦截、或手动安装.vsix文件。
插件加载失败，90% 以上不是插件本身坏了，而是 VSCode 根本没连上扩展市场——它卡在请求 marketplace.visualstudio.com 这一步，DNS 污染、TLS 握手被重置、或域名被拦截，都会导致“转圈”“空白页”“XHR failed”“Unable to fetch extensions”。
改 extensions.gallery.serviceUrl 换国内镜像源
VS Code 不会自动 fallback 到备用源，它死守默认地址。不改这个配置，清缓存、重启、重装都没用。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Preferences: Open 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 配置
很多用户开了 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 - 更彻底：进
settings.json，删掉整行"http.proxy": ""和"http.proxyStrictSSL": false（后者会削弱证书校验，仅调试用） - 确认无残留后重启 VSCode
检查是否被本地安全软件静默拦截
某些国产杀毒软件（如 360、腾讯电脑管家）或企业级终端管控工具，会静默拦截 VSCode 对非标准域名（如 cdn.azure.cn）的 HTTPS 请求，不报错、不弹窗，只让请求无声超时。
- 验证方式很简单：在浏览器里直接打开
https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/，能进说明网络通路没问题 - 若浏览器能访问，但 VSCode 仍失败，大概率是安全软件劫持了 socket 连接
- 临时关闭杀毒软件或添加 VSCode 到白名单，再试一次
- 企业环境可联系 IT 部门确认
vscode.cdn.azure.cn和open-vsx.org是否被策略拦截
手动安装 .vsix 绕过网络请求
当自动流程反复失败，最稳的方式是跳过 marketplace 请求，直接装离线包。VSCode 插件本质是 .vsix 文件，可从官网下载后本地安装。
- 打开
https://marketplace.visualstudio.com/items?itemName=ms-python.python（把ms-python.python换成你要的插件 ID） - 滚动到底部点 “Download Extension”，得到
python-2024.12.1.vsix这类文件 - 在 VSCode 里按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选中该文件 - 安装前建议用 ZIP 工具打开
.vsix，检查根目录下package.json中的engines.vscode字段，确认与你当前 VSCode 版本兼容（如"^1.90.0"表示最低需 1.90）
真正容易被忽略的是：双击图标启动的 VSCode 压根不继承 shell 里的 HTTP_PROXY 环境变量，哪怕你在终端里 export HTTPS_PROXY=... 也没用——所以别指望靠改环境变量绕过问题。
