根本原因是dns污染和网络路由绕行导致无法稳定连接packagist.org，需全局配置https镜像源（如阿里云https://mirrors.aliyun.com/composer/）、清缓存并验证config输出为完整json，镜像仅加速官方仓库且不代理私有包。
为什么 composer install 总是卡在 packages.json 或超时？
国内直接连官方 Packagist（packagist.org）经常失败或极慢，本质是 DNS 污染 + 网络路由绕行导致连接不稳定。不是你项目写错了，也不是 Composer 本身有问题，而是请求根本没发出去，或者发出去了但等不到响应。
镜像不是“加速器”，而是把 packagist.org 的元数据和包文件缓存在国内服务器上，让 composer 命令实际访问的是本地就近节点。
- 必须用 HTTPS 镜像源，HTTP 已被现代 Composer 版本拒绝（会报
Invalid repository type或 SSL 错误） - 镜像只代理
packagist.org官方仓库，不支持私有包或自定义 VCS 仓库——那些得单独配置 - 不同镜像更新频率不同：阿里云、腾讯云通常 5–10 分钟同步一次；华为云偶尔延迟半小时以上
如何全局切换到阿里云镜像（推荐）？
全局设置影响所有项目，适合开发机或 CI 环境统一管理。执行以下命令即可：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会写入 ~/.composer/config.json（Linux/macOS）或 %USERPROFILE%\Composer\config.json（Windows），后续所有 composer install、composer update 都自动走阿里云。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 如果之前设过其他镜像（比如腾讯云），这条命令会覆盖，无需手动删旧配置
- 验证是否生效：运行
composer config -g repo.packagist，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 若遇到
Could not fetch https://mirrors.aliyun.com/composer/packages.json，先ping mirrors.aliyun.com看通不通，再检查公司是否封了该域名
单个项目临时换源，不污染全局配置
有些项目依赖私有包，必须走内网仓库，又不想改全局配置。这时在项目根目录下执行：
composer config repo.packagist composer https://mirrors.tencent.com/composer/
这会在当前项目的 composer.json 同级生成或修改 composer.lock 所在目录的 composer.json，添加 "repositories" 字段。注意：
- 该设置只对当前目录有效，
cd到子目录也不继承 - 如果项目已有
"repositories"数组，别直接覆盖，要合并进去，否则可能丢失私有仓库配置 - 执行后记得
git add composer.json—— 这个改动会影响团队其他人，属于协作约定的一部分
镜像失效或版本不一致怎么办？
偶尔遇到 composer install 报 Package ... not found，但官网明明有，大概率是镜像同步滞后或缓存脏了。
- 先清 Composer 本地缓存：
composer clear-cache，再重试 - 检查镜像状态页：阿里云镜像首页（
https://mirrors.aliyun.com/composer/）底部有“最后同步时间”，若超过 1 小时未更新，换腾讯云或华为云试试 - 临时回退官方源调试：
composer config -g repo.packagist composer https://packagist.org，确认是不是镜像问题 - 某些老旧项目用了
composer.lock中带 hash 的旧版本包，而镜像只同步最新版元数据——此时需删掉composer.lock重新生成，或手动指定稳定版本号
镜像不是万能的，它解决的是网络层瓶颈；真正卡住的，往往是项目自身依赖树太深、require-dev 太多，或者某几个包本身下载慢（比如含大二进制文件的扩展）。这时候得看 composer why-not xxx 或 --profile 参数定位真凶。
