插件加载失败主因是vscode无法连接扩展市场，应优先修改extensions.gallery.serviceurl为国内镜像源如"https://vscode.cdn.azure.cn/extensiongallery/extensiongallery/"，并彻底退出进程后重启。
插件加载失败，90% 以上不是插件本身坏了，而是 VS Code 根本没连上扩展市场——它卡在请求 marketplace.visualstudio.com 这一步，DNS 解析失败、TLS 握手被重置、或域名被拦截，都会导致“转圈”“空白页”“XHR failed”“Unable to fetch extensions”。
改 extensions.gallery.serviceUrl 是最快生效的解法
VS Code 不会自动 fallback 到备用源，它死守默认地址。不改这个配置，清缓存、重启、重装都没用。
- 必须完全退出 VS Code（Windows 右键任务栏 → 退出；macOS 在 Activity Monitor 杀掉所有
Code和Code Helper进程） - 打开命令面板
Ctrl+Shift+P→ 输入并选择Preferences: Open Settings (JSON) - 添加这行（注意逗号位置，末尾必须带
/）："extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/" - 保存后重新启动，再点扩展图标。首次加载可能稍慢，但不再卡住
如果公司网络封了 cdn.azure.cn，可换阿里云镜像："extensions.gallery.serviceUrl": "https://vscode-extensions.oss-cn-hangzhou.aliyuncs.com/extensionGallery/extensionGallery/"
code --install-extension 命令失败时先查 .vsix 兼容性
手动下载的 .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”——签名校验通不过，安装仍会中止
代理配置错一个字符就全挂，且 VS Code 不继承系统环境变量
http.proxy 设成 http://127.0.0.1:8080 但 Clash 没开 HTTP 代理端口？那所有扩展请求都会卡在 Pending 状态，控制台里看不到错误，只显示空白。
- 进设置搜
proxy，把HTTP: Proxy值清空，或设为none - 别碰
VSCODE_PROXY_SUPPORT—— 这个变量根本不存在，是网上误传 - 真正有效的是系统级
HTTP_PROXY/HTTPS_PROXY，但仅当用终端执行code启动时才继承 - 双击图标启动的 VS Code，压根读不到 shell 里的
export HTTPS_PROXY=...
验证是否真连得上：在终端运行 curl -v https://marketplace.visualstudio.com。如果 curl 成功而 VS Code 失败，问题一定出在 VS Code 自身配置或进程残留上。
杀不干净的 Code Helper 进程会让所有修复失效
你以为关了窗口就结束了？Windows 任务栏托盘、macOS 活动监视器里还蹲着几个 Code Helper 或 GPU Process，它们缓存着旧的网络配置和证书状态。
- Windows：任务管理器 → 详细信息 → 结束所有含
Code和Helper的进程 - macOS：Activity Monitor → 搜索
Code→ 全部右键强制退出 - Linux：
killall -9 code和killall -9 code-helper - 做完再启动，否则改了配置也白搭
最常被忽略的一点：某些国产安全软件（如 360、腾讯电脑管家）会静默拦截对 cdn.azure.cn 这类非主流域名的 HTTPS 请求，不弹窗、不报错，只让请求超时——这种拦截无法通过 VS Code 设置绕过，只能临时禁用安全软件验证。
