VSCode扩展安装失败主因是无法访问marketplace.visualstudio.com，应先诊断网络请求，再尝试关闭自动更新、检查代理、切换vscode-cn镜像源或离线安装排查。
VSCode 扩展安装失败：先看网络请求是否卡在 marketplace.visualstudio.com
绝大多数“点击安装没反应”“进度条卡住”“提示下载超时”的问题，本质是 VSCode 无法连通微软官方扩展市场。它默认走的是境外 CDN，国内直连大概率被限速或中断。
实操建议：
- 打开 VSCode 设置（
Ctrl+,），搜索extensions.autoCheckUpdates，暂时关掉——避免后台静默请求干扰诊断 - 在命令面板（
Ctrl+Shift+P）运行Developer: Toggle Developer Tools，切到Network标签页，再点一次“安装”，观察是否有大量marketplace.visualstudio.com请求失败或 pending 超过 30 秒 - 如果确认是网络问题，别急着换镜像源——先试下系统代理是否被意外启用（比如开了 Clash、Surge 等工具但未全局，导致 VSCode 拿不到代理配置）
用国内镜像源替代官方 marketplace（推荐 vscode-cn）
微软没提供官方镜像，但社区维护的 vscode-cn 镜像是目前最稳定、更新及时的替代方案，它把扩展包缓存到国内服务器，并兼容 VSCode 原有协议。
实操建议：
- 关闭 VSCode，编辑用户设置文件：
%APPDATA%\Code\User\settings.json（Windows）或~/Library/Application Support/Code/User/settings.json（macOS）或~/.config/Code/User/settings.json（Linux） - 添加以下两行配置（注意逗号分隔）：
"extensions.gallery.serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery", "extensions.gallery.cacheUrl": "https://marketplace.visualstudio.com/_apis/public/gallery/publishers"
- 把上面两个 URL 中的
marketplace.visualstudio.com全部替换成vscode.cdn.azure.cn（这是vscode-cn的实际域名） - 重启 VSCode，再进扩展页试试——不是所有扩展都立刻显示，首次加载可能稍慢，但安装成功率会明显提升
installExtension 命令失败：离线安装时路径或格式不对
手动下载 .vsix 文件后双击无反应，或用命令行 code --install-extension xxx.vsix 报错，常见原因是文件损坏、签名不匹配，或 VSCode 版本太旧不支持该扩展的引擎要求。
实操建议：
- 检查
.vsix文件是否完整：用解压工具打开，确认里面有extension/package.json，且其中engines.vscode字段值 ≤ 当前 VSCode 版本（比如你用 1.85，扩展写"^1.90.0"就装不上） - 不要用浏览器“另存为”下载 VSIX——某些网站返回的是 HTML 页面而非真实文件，建议从扩展页点“Download Extension”按钮，或直接右键链接另存为
- 命令行安装时，确保路径不含中文或空格；若报
ENOENT，说明路径错了，用绝对路径重试，例如：code --install-extension /Users/xxx/Downloads/vscode-eslint-2.4.0.vsix
插件装上了但不生效：可能是禁用状态或依赖冲突
扩展列表里显示“已安装”，但功能没出现（比如 Prettier 不格式化、ESLint 不标红），往往不是安装失败，而是被自动禁用，或与其他插件抢了激活时机。
实操建议：
- 在扩展页搜索框输入
@installed，再挨个点开，确认状态栏显示“启用”而非“已禁用”——有些插件会在检测到冲突时自行禁用自己 - 打开命令面板，运行
Developer: Show Running Extensions，看目标插件是否在列表中且“Activation Time”非零；如果一直是0ms，说明它根本没被触发启动 - 临时禁用其他同类插件（比如同时装了
ESLint和prettier-vscode，又都绑了保存格式化，容易互相压制），再逐个启用排查
扩展市场的网络链路其实很脆弱，镜像源能解决大部分问题，但个别新发布扩展可能延迟同步几小时。遇到某个特定插件死活装不上，先查它的 GitHub Issues 页，比反复换源更省时间。
