VSCode插件市场报错主因是URL配置错误或服务端拒绝，须同步配置serviceUrl和itemUrl且均以/结尾，否则404静默重试；禁用search.useIgnoreFiles可排除.gitignore干扰，DevTools Network面板查Status码精准定位失败环节。
VSCode插件市场搜索接口报错（如 ERR Failed to fetch、rate_limited、卡在“重试中”）不是你网络差，而是 VSCode 客户端主动向服务端发起的请求被拦截或拒绝——根源在 URL 配置错误、速率策略冲突、或服务端返回了 429/404 等明确拒绝信号。
检查 serviceUrl 和 itemUrl 是否配对且带斜杠
只改 extensions.gallery.serviceUrl 不够，必须同步配置 extensions.gallery.itemUrl，否则 VSCode 会静默请求一个不存在的路径，返回 404 后无限重试。
- 两个 URL 都必须以
/结尾，例如："https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/" - 若用 Open-VSX 源，
itemUrl必须显式写为"https://open-vsx.org/vscode/item/"，不能省略/vscode/item/路径段 - Windows 用户复制 URL 时容易混入全角空格或换行符，建议手动敲一遍，不要粘贴
禁用 search.useIgnoreFiles 防止误过滤扩展元数据
这个设置本意是跳过 .gitignore 里的文件，但它也会影响插件市场请求的缓存清单加载逻辑——尤其当项目根目录存在 .ignore 或 .gitignore 且内容异常时，VSCode 可能拒绝拉取扩展索引。
- 临时在设置中设为
false，看是否解除“重试中”状态 - 这不是长期方案，仅用于验证：如果关掉后立刻能搜到插件，说明问题出在 ignore 文件解析环节
- 注意：关掉后全局搜索也会忽略
.gitignore，但插件市场本身不依赖它
识别真实失败原因：打开 DevTools 看 Network 请求
别猜“是不是代理问题”，直接看实际 HTTP 响应。运行 Developer: Toggle Developer Tools → 切到 Network 标签页 → 点一次“搜索”或“安装”，观察失败请求的三项关键字段：
- Status 是
(failed) net::ERR_CONNECTION_TIMED_OUT→ DNS 或 TLS 层断开，换镜像源或关代理软件的 TUN 模式 - Status 是
404→ URL 写错（最常见是漏斜杠或域名拼成viscode） - Status 是
0且 Timing 显示 stalled >30s → 本地安全软件（如 360、火绒）静默丢包，非网络问题
绕过客户端限速：用命令行直连 marketplace API
VSCode 的搜索请求走的是封装过的 Electron 网络栈，受其内部节流和证书校验限制；而 curl 或 PowerShell 调用原始 API 更稳定。
- 查某个插件是否存在：
curl -s "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/esbenp/vsextensions/prettier-vscode/9.14.0" | jq .displayName - 获取最新版列表：
curl -s "https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery" -H "Content-Type: application/json" --data-binary @query.json（需构造 query.json） - 拿到
.vsix下载地址后，用浏览器或 wget 下载，再通过Extensions: Install from VSIX手动装
真正难处理的不是“搜不到”，而是 VSCode 把失败藏得太深——它不告诉你哪个 URL 404，也不提示哪条 ignore 规则导致元数据加载中断。每次重试前，先看 DevTools Network，比反复重启快十倍。
