Composer安装失败主因是packagist.org国内访问不稳定，应优先全局切换为清华镜像源：composer config -g repo.packagist composer https://packagist.mirrors.tuna.tsinghua.edu.cn，并检查地址格式、证书、Composer版本及GitHub协议配置。
Composer 安装包失败，大概率不是你网络差，而是默认源 packagist.org 在国内访问不稳定，DNS 污染、TLS 握手超时、CDN 节点不可达都可能导致 composer install 卡在 “Loading composer repositories” 或报错 Could not fetch https://repo.packagist.org/packages.json。
怎么快速确认是源的问题？
执行命令看是否能通：
curl -I https://repo.packagist.org/packages.json
如果返回 HTTP/2 503、超时或空响应，基本就是源不可用。此时换镜像不是“优化”，而是必要步骤。
- 别试
ping packagist.org—— 它不响应 ICMP，毫无参考价值 - 别只改
composer.json的repositories—— 这只影响当前项目，全局失效仍会卡在初始化阶段 - 优先用
composer config -g repo.packagist全局设置，而非项目级覆盖
国内可用镜像选哪个？
清华、阿里、华为三者目前最稳，但行为有差异：
-
https://packagist.phpcomposer.com已停用，别再搜到就配 - 清华源
https://packagist.mirrors.tuna.tsinghua.edu.cn同步延迟约 5–10 分钟，适合绝大多数场景 - 阿里源
https://mirrors.aliyun.com/composer/对私有包兼容性略好，但偶尔因 CDN 缓存导致新版本延迟出现 - 华为源
https://mirrors.huaweicloud.com/repository/php支持 IPv6，适合双栈环境，但首次同步慢
推荐默认用清华源，命令一行搞定：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
composer config -g repo.packagist composer https://packagist.mirrors.tuna.tsinghua.edu.cn
换源后 still 报错？检查这几个点
镜像地址写错、HTTPS 证书验证失败、本地 Composer 版本太老，都可能让换源失效：
- 确保地址末尾没多加
/——https://.../cn是错的，正确是https://.../ - 若提示
Peer certificate cannot be authenticated，说明系统 CA 证书过期，运行composer self-update --update-keys - PHP 8.2+ 环境下，Composer v2.2 以下版本可能无法解析新版镜像返回头，升级到
v2.5+更稳妥：composer self-update - 公司内网可能拦截了镜像域名，可临时加
--no-plugins排除插件干扰：composer install --no-plugins
为什么有时候换源也没用？
真正卡住的往往不是 packages.json，而是具体包的 dist URL（比如 GitHub release ZIP）。镜像只代理 metadata，不托管所有 dist 文件。
这时要配合 composer config -g github-protocols https，强制走 HTTPS 而非 Git 协议；再加一条：
composer config -g secure-http false
——仅当确认镜像支持 HTTP（如某些内网镜像）才开，公网环境不建议关 secure-http。
最麻烦的情况是：包作者把 dist.url 写死成 GitHub raw 链接，而 GitHub 在国内极不稳定。这种包只能手动 fork + 替换 dist，没有通用解法。
