VSCode插件安装失败主因是网络或代理配置冲突，需检查VSCode代理设置、系统代理及环境变量HTTP_PROXY/HTTPS_PROXY是否一致，验证marketplace.visualstudio.com可达性，清理扩展缓存，必要时手动安装.vsix文件。
VSCode插件安装失败，八成是网络或代理“悄悄”挡了路——不是插件坏了，也不是VSCode出问题，而是请求根本没发出去，或者发出去了却收不到响应。
检查 VSCode 代理配置是否冲突
代理设置错位是最隐蔽的“静默失败”原因：你开了代理但 VSCode 没配，或 VSCode 配了代理但系统/环境变量又关着，甚至填错了端口（比如把 7890 写成 789），都会导致 Failed to fetch 或 ETIMEDOUT 错误。
- 打开 VSCode 设置（
Ctrl+,），搜索proxy，确认http.proxy和https.proxy值正确或为空 - 同时检查系统级代理：Windows 进入「设置 → 网络和 Internet → 代理」，macOS 进入「系统设置 → 网络 → 高级 → 代理」，确保与 VSCode 一致
- 还要查环境变量：
HTTP_PROXY和HTTPS_PROXY（Windows 在「系统属性 → 环境变量」，macOS/Linux 在~/.zshrc或~/.bashrc中）——它们会强制覆盖 VSCode 设置，哪怕你在界面里留空了
验证 marketplace.visualstudio.com 是否可达
VSCode 安装插件时实际访问的是 https://marketplace.visualstudio.com 及其 API 子路径（如 /vscode）。如果这个域名被 DNS 污染、被企业防火墙拦截，或本地 hosts 被错误映射，就会卡在“正在下载…”不动。
- 终端执行：
curl -v https://marketplace.visualstudio.com/vscode
，看是否返回 HTTP 200；若超时或报Could not resolve host，说明网络层已断 - 尝试临时换 DNS：Windows/macOS 将 DNS 改为
8.8.8.8或1.1.1.1，再测试 - 国内用户可加 hosts 映射（需确认 IP 有效）：
20.190.156.134 marketplace.visualstudio.com
（该 IP 来自近期实测可用，但可能随微软 CDN 变更）
清理扩展缓存与临时文件
VSCode 下载中断后残留的损坏 .vsix 或临时解压目录，会让后续安装直接复用坏文件，报“提取扩展时出错”，而日志里只显示模糊的 ENOENT 或 EACCES。
- 关闭 VSCode
- 删除以下目录内容（注意：不是删整个文件夹，是清空里面）：
Windows：%USERPROFILE%\.vscode\extensions
macOS/Linux：~/.vscode/extensions - 顺手删掉临时缓存：
~/.vscode/.extensions/.tmp（Linux/macOS）或%USERPROFILE%\.vscode\.extensions\.tmp（Windows） - 重启 VSCode 后再试——别跳过重启，因为扩展主机进程（
exthost）会缓存旧状态
手动安装 .vsix 是最稳的兜底方案
当网络反复失败、公司策略严格、或急需某个插件调试时，手动安装不是“退而求其次”，而是最可控的方式。关键点在于：必须从可信源下载，且版本要匹配你的 VSCode 版本（尤其注意 Requires Visual Studio Code ^1.80.0 这类提示）。
- 前往官方市场页（
https://marketplace.visualstudio.com/items?itemName=ms-python.python）或国内镜像站（如 Open VSX Registry）搜索插件 - 点击
Download Extension，保存为xxx-1.2.3.vsix - 在 VSCode 中按
Ctrl+Shift+P，输入并运行命令：Extensions: Install from VSIX，选中刚下载的文件 - 安装完成后，检查是否启用——有些插件（如
Go工具链）还需额外配置go env -w GOPROXY=https://goproxy.cn
真正卡住人的，往往不是“不会装”，而是不知道该去哪看日志、该清哪个路径、该信哪个代理层级。多一个 curl -v 测试，少一次盲目重装；多确认一次环境变量，就少一次“明明配了却不生效”的抓狂。
