VSCode扩展搜索失败是因无法连接扩展市场服务端，需检查网络、代理、防火墙，更换镜像源（如https://vscode.cdn.azure.cn/），清缓存并彻底重启，或用ID直装、离线安装.vsix。
VSCode 搜索框转圈或显示 “Unable to fetch extensions”
这不是插件被下架，而是 VSCode 根本没连上扩展市场服务端。常见表现是搜索框一直转圈、下方提示 XHR failed、或者只显示“已安装”标签页——说明网络请求在发起阶段就失败了。
- 终端执行
curl -v https://marketplace.visualstudio.com，看是否返回 200；超时或 403 就确认是通路问题 - 检查 VSCode 设置里
http.proxy和https.proxy是否填错（比如写了https://127.0.0.1:7890，但实际只支持http://协议） - 临时关闭 Clash/Fiddler/企业防火墙——它们常静默拦截带
User-Agent: vscode/的请求，浏览器能打开 marketplace ≠ VSCode 能连 - 杀掉所有
Code.exe/Code Helper进程再重启，避免旧进程缓存坏掉的连接状态
改 extensions.gallery.serviceUrl 镜像源最稳
微软官方源在国内不稳定，社区维护的 https://vscode.cdn.azure.cn 是目前兼容性最好、同步最全的镜像。配错一个字符或漏掉末尾斜杠，VSCode 就会静默卡住不报错。
- 按
Ctrl+Shift+P→ 输入并选择Preferences: Open Settings (JSON) - 在
{}内添加两行（注意逗号分隔、URL 末尾必须有/）："extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/",<br>"extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/publishers"
- 保存后彻底退出 VSCode（Windows 用任务管理器杀光所有 Code 进程；macOS 用活动监视器；Linux 执行
pkill -f "code"） - 重启后进扩展面板，搜任意关键词（如
prettier），应立刻出结果
知道插件 ID 但搜不到，直接用命令安装
搜索界面空白不代表插件不可装，Extensions: Install Extension 命令走的是独立请求路径，常能绕过 UI 层的加载失败。
- 按
Ctrl+Shift+P→ 输入并执行Extensions: Install Extension（不是 “Install from VSIX”） - 在弹出输入框中直接粘贴插件 ID，例如
ms-python.python或baidu.wenxin-enterprise - 回车后 VSCode 会尝试拉取元数据并安装；若提示 “Extension not found”，说明当前源确实没收录该 ID，此时需切镜像或离线
- 命令行方式
code --install-extension ms-python.python失败，先运行where code（Windows）或which code（macOS/Linux）确认code命令已注册进 PATH
离线装 .vsix 时提示 “Download failed”
这个错误不是下载环节出问题，而是 VSCode 在加载前校验阶段拒绝执行——常见于文件损坏、签名不匹配或路径权限异常。
- 优先从插件 GitHub Release 页面下载，例如 C/C++ 插件去
https://github.com/microsoft/vscode-cpptools/releases找 Assets 中的.vsix - 别从第三方聚合站下，容易版本错乱或签名缺失；确认文件名含正确标识，如中文包必须是
vscode-language-pack-zh-hans.vsix - 拖拽安装时，确保 VSCode 是以当前用户身份运行；WSL 或 NTFS 挂载卷下，检查
~/.vscode/extensions目录是否可写 - 安装失败后删掉
~/.vscode/extensionsCache目录再试——这是磁盘缓存索引，损坏会导致元数据解析失败
