vs code 插件搜索失败或安装异常的根源在于网络请求层故障或配置错误，需检查自动更新开关、市场源 url、代理环境、插件 id 准确性、激活状态及插件目录路径。
搜索框一直转圈或显示“无结果”
这不是插件下架了，而是 VS Code 根本没拿到 marketplace.visualstudio.com 的响应——DNS 解析失败、TLS 握手被中断、或返回空 body，都会表现为 UI 卡在 loading 或列表为空。汉化、主题、字体设置全都不影响这个链路，问题只出在网络请求层。
先确认两个开关是否打开：extensions.autoUpdate 和 extensions.autoCheckUpdates，必须都设为 true；否则 VS Code 连市场都不发请求。再检查 Extensions 视图右上角标签页是不是误切到了 “已禁用” 或 “已安装”，新插件只出现在 “Search Extensions in Marketplace” 页签里。
用插件 ID 直接安装却提示 “Extension not found”
说明当前配置的市场源（extensions.gallery.serviceUrl）确实没收录该 ID。常见于：
- 你正在用 open-vsx.org 镜像（VS Code 1.85+ 默认 fallback），但
ms-vscode.cpptools这类微软官方插件未同步过去 - 企业网络静默丢弃带
User-Agent: vscode/的请求，浏览器能打开 marketplace，VS Code 就不行 -
serviceUrl或cacheUrl配错一个字符、少一个斜杠（比如末尾缺/），VS Code 会静默失败，不报错只重试
最稳解法：关闭 VS Code，编辑 settings.json，替换为社区镜像：
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery", "extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery/publishers"
注意 URL 末尾的 / 不能省，重启后执行 Extensions: Install Extension 命令再粘贴 ID，比如 ms-python.python。
code --install-extension 命令总失败
失败主因不是网络，而是环境没对齐：
-
where code（Windows）或which code（macOS/Linux）无输出 →code命令没注册进 PATH，需在 VS Code 里执行Shell Command: Install 'code' command in PATH - 终端里设了
HTTP_PROXY，但你是双击图标启动 VS Code，它读不到该变量 - 插件 ID 写错，比如把
esbenp.prettier-vscode缩写成prettier-vscode，VS Code 返回 “Extension not found” - 插件已存在但被禁用，
--force参数必须加：code --install-extension esbenp.prettier-vscode --force
插件装上了但图标灰色、功能不生效
这不是安装失败，是插件没激活。尤其语言类（如 ms-python.python）或服务器型插件（如 ms-vscode.vscode-typescript-next），不重启窗口等于没装。
务必执行 Developer: Reload Window（Ctrl+Shift+P 输入后回车），不能只点右下角提示里的“重启”。还要检查左下角齿轮 → Extensions → 找到该插件 → 右上角若显示 Disable (Workspace)，说明它在当前项目里被关掉了。另外滚动到插件详情页底部看 engines.vscode 字段，比如 "^1.85.0" 表示最低要 VS Code 1.85，旧版本装了也起不来。
真正容易被忽略的是：VS Code 启动时读取的插件目录未必是你以为的那个路径。运行 code --list-extensions 输出为空？再跑 code --show-versions 看顶部的 User data directory，它可能指向自定义路径，或被 Flatpak 沙箱屏蔽，或权限锁死（比如属主变成 root）。这些底层路径问题，比代理设置更难排查，也更常导致“插件消失”。
