VSCode插件下载失败多因网络、代理或安全软件拦截，非插件本身问题；应先查控制台报错、测试 marketplace 访问、检查代理设置与安全软件，并通过开发者工具定位 stalled 请求或扩展主机崩溃原因。
VSCode插件下载失败，90% 不是插件问题，而是网络、配置或进程状态卡在某个环节。直接看控制台报错类型，比反复重试更省时间。
看到 “XHR failed” 或 “Failed to fetch” 怎么办
这是 VS Code 客户端发请求去 marketplace.visualstudio.com 时被中断，不是插件坏了，是通道断了。
- 先打开浏览器，手动访问
https://marketplace.visualstudio.com—— 能打开说明基础网络通，不能开就先查系统代理或公司防火墙 - 进 VS Code 设置搜
http.proxy，如果值是非空字符串（比如http://127.0.0.1:8080）但你没开代理工具，删掉整行再重启 - 终端执行
curl -v https://marketplace.visualstudio.com，如果也失败，问题出在网络层；如果 curl 成功但 VS Code 失败，临时加一行"http.proxyStrictSSL": false到settings.json测试（仅测试，勿长期保留）
进度条卡在 0%，Network 面板显示 stalled
典型表现是点击 Install 后毫无反应，开发者工具（Ctrl+Shift+I → Network 标签）里请求一直 pending 或 stalled。这基本锁定是本地安全软件（如火绒、360、腾讯电脑管家）静默拦截了 VS Code 的 HTTPS 请求。
- 临时退出这类安全软件，再试一次安装
- 检查 Windows 系统设置 → 网络与 Internet → 代理 → 手动设置代理是否被意外开启（常见于企业 IT 统一策略）
- 不建议全局开代理：VS Code 不继承系统环境变量里的
HTTP_PROXY，必须显式配http.proxy，且容易因证书校验失败反而出错
离线安装 .vsix 却提示 “not compatible with VS Code”
错误信息里带 ms-ceintl.vscode-language-pack-zh-hans 和具体版本号（如 '1.90.1'），说明是 package.json 里的 engines.vscode 字段匹配失败，不是文件损坏。
- 用 7-Zip 或
unzip解压 .vsix（本质是 zip），打开extension/package.json（注意不是根目录那个） - 把
"vscode": "^1.103.0"改成当前 VS Code 版本能接受的范围，例如"vscode": ">=1.85.0"（以code --version输出为准） - 改完保存，重新打包为 zip，后缀名手动改为
.vsix，再用命令面板运行Extensions: Install from VSIX - 别指望下旧版语言包——微软已停更，历史版本常灰显不可选，且旧包的
engines.vscode可能仍写死为"^1.80.0"，和你的1.85.1小版本差一点也会被拒
装完插件却没反应，或 Extension host terminated unexpectedly
这不是安装失败，而是某个已安装插件在激活时崩溃了扩展主机进程，导致所有插件功能（语法高亮、补全、格式化）集体失效。
- 按
Ctrl+Shift+P运行Developer: Toggle Developer Tools，看 Console 里有没有红字报错，重点找含activate、require、Cannot find module的日志 - 启动时加
--disable-extensions参数：code --disable-extensions，再逐个启用插件定位问题源 - 检查
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）下是否有名称含.incomplete或时间戳异常的残留文件夹，直接删掉 - 某些插件（如老版 Python 扩展）调用了已被废弃的 API（如
vscode.workspace.rootPath），升级插件或换兼容版本即可
真正卡住人的，往往不是报错本身，而是它藏在多层路径之下：可能是 locale.json 写错值、可能是 extensions.installDir 指向了一个不存在的目录、也可能是 WSL 里 .vscode/extensions 权限被挂载机制锁死了。遇到“怎么都不行”，先确认 VS Code 进程是否彻底退出（任务管理器里杀光 Code Helper 和 Code），再动手改配置。
