“XHR failed”意味着VSCode本地客户端发起的HTTP请求因网络中断而失败，并非插件问题；本质是无法连接marketplace.visualstudio.com，常见于代理配置错误、DNS解析失败、TLS握手被重置或企业防火墙拦截。
报错信息里出现“XHR failed”意味着什么
这根本不是插件本身的问题，而是 VSCode 无法发出 HTTP 请求去拉取插件列表或下载包——本质是网络通道断了。常见于国内直连 marketplace.visualstudio.com 被限速、DNS 解析失败或中间代理干扰。
- 打开开发者工具（
Ctrl+Shift+I），切到Network标签页，点一次插件搜索，看有没有对https://marketplace.visualstudio.com/_apis/public/gallery/的请求发出；没请求=代理没生效，请求卡在Pending=DNS 或连接超时 -
http.proxy必须显式配置，且格式必须是http://127.0.0.1:7890（带协议头、用 IP、不能写localhost）；Windows/macOS 默认把127.0.0.1加入 bypass 列表，填了也可能被跳过 - 临时验证是否网络层问题：终端执行
curl -v https://marketplace.visualstudio.com，如果也失败，说明不是 VSCode 的锅，得找 IT 或换网络
“Failed to install extension”背后的真实原因
这个提示常被误认为下载失败，实际多是本地校验或签名验证环节崩了——尤其是 VSCode 1.85+ 启用了更严格的插件签名策略，且 Marketplace 源已默认切到 open-vsx.org，部分插件未同步或签名不匹配。
- 先执行
Developer: Reload Window（Ctrl+Shift+P输入），再试安装；无效就右键已安装插件 →Uninstall，重启 VSCode 后重装 - 检查插件页面的
engines.vscode字段（如"^1.75.0"），确认你当前 VSCode 版本（code --version输出）满足要求；1.91.0 装只声明支持到 1.90.0 的插件会静默拒绝 - 某些插件（如
Prettier、ESLint）需额外安装全局 CLI 工具，仅装插件不生效；务必查 README 是否要求npm install -g eslint
中文语言包装了但界面仍是英文？关键路径错了
VSCode 不会自动启用语言包，Configure Display Language 是唯一能写入生效配置的入口。跳过这步，装十遍也没用——而且它只认 locale.json 文件里的 {"locale": "zh-cn"}，其他地方写的都无效。
- 必须用
Ctrl+Shift+P打开命令面板，输入并执行Configure Display Language，从列表选zh-cn（不是zh、Chinese或zh-hans），选完后点Restart（仅关闭再手动打开不算） -
locale.json路径必须准确：
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
Linux：~/.config/Code/User/locale.json - 文件内容必须是合法 JSON：
{"locale": "zh-cn"}（双引号、冒号后有空格、值全小写），若该文件存在但值是"en"，大概率被工作区设置或远程开发环境覆盖，可先File > Close Folder再执行命令
离线安装 .vsix 提示 “not compatible with Code” 怎么办
这不是包坏了，而是 package.json 里声明的 engines.vscode 版本范围和你本地 VSCode 主版本号不匹配。VSCode 严格比对这个字段，差一个小版本都可能拒装。
- 用
unzip -l your-plugin.vsix确认根目录下有extension/package.json；Windows 用户可用 7-Zip 解压，别用资源管理器双击解压再重命名，会破坏 ZIP 结构 - 打开
package.json，找到"engines": {"vscode": "^1.85.0"}这行，改成你本地code --version输出的主版本号（如1.91.0→ 改成"^1.91.0"） - 重新打包必须用
zip命令或 7-Zip，确保压缩方式为 “store” 或 “deflate”，且无额外目录层级；改完后用vscode --install-extension your-plugin.vsix命令行验证
所有路径类问题（安装路径含中文、用户数据目录权限不足、自定义 extensions.installDir 不存在）都会导致静默失败，且无法通过设置修复——尤其是中文安装路径，必须重装到纯英文路径，没有例外。
