阿里云镜像源可解决90%的composer安装问题；正确配置需三要素：key为repo.packagist、type值为composer、url末尾带斜杠；项目级配置更可靠，换源后须删除composer.lock和vendor重装验证。
直接换阿里云镜像源就能解决 90% 的 composer install 卡死、超时、503 问题；其他镜像要么同步延迟高，要么已停更，要么不支持 Composer 2.x 元数据格式。
为什么 composer config -g repo.packagist 总是不生效
不是网络慢，是命令写错了——Composer 2.x 硬编码只认 repo.packagist 这个 key，多一个 s（比如 repos.packagist）、少一个 composer type 值、URL 缺末尾 /，都会静默失败且不报错。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ 三者缺一不可 - 漏掉
composer（type 值）→ fallback 到官方源，等于白配 - URL 写成
https://mirrors.aliyun.com/composer（少斜杠）→ 请求路径拼成/composerpackages.json，404 - 验证是否成功：运行
composer config -g repo.packagist，输出必须是完整 JSON 对象，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
项目级配置比全局更可靠，尤其要提交到 Git
全局配置无法被版本控制，团队新人拉代码后行为不一致；CI 流水线若混用不同镜像，会导致 composer.lock hash 不一致、部署失败。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 进项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意去掉-g） - 该命令会自动向
composer.json的repositories字段追加一条"packagist"配置，不覆盖已有私有源 - 必须显式加
"packagist.org": false，否则 Composer 仍可能回退到官方源触发超时 - 如果
composer.json已有repositories字段，别手动编辑 JSON，用命令追加更安全
composer update 卡在 Resolving dependencies？和镜像无关
镜像只加速包下载，不加速依赖解析。这个阶段卡住，说明问题出在本地环境或 composer.json 写法上。
- 常见诱因：
"php": "^7.4 || ^8.0"这类宽泛版本约束、大量未锁定的dev-包、require-dev里塞了太多工具链 - GitHub 直链仓库（
"type": "package"或"url": "https://github.com/..."）不受镜像加速，composer.lock里仍是原始 GitHub URL，需删掉composer.lock和vendor/后重装 - 某些扩展（如
ext-redis）由phpize编译安装，和镜像完全无关，慢是编译耗时
当前稳定可用的镜像源只有三个
截至 2026 年 5 月，经实测能响应、元数据完整、支持 HTTPS 和 Composer 2.x 的只剩阿里云、腾讯云、清华源；中科大、华为云偶发同步延迟，packagist.phpcomposer.com 已彻底 404。
- 阿里云：
https://mirrors.aliyun.com/composer/—— 同步最快、CDN 覆盖全、无维护风险，生产首选 - 腾讯云：
https://mirrors.cloud.tencent.com/composer/—— 华南地区延迟更低，适合部署在腾讯云服务器上的项目 - 清华源：
https://mirrors.tuna.tsinghua.edu.cn/composer/—— 带宽足，适合批量安装大体积依赖，但新包上线可能晚几小时 - 所有 HTTP 地址（如
http://...）已被 Composer 2.2+ 默认禁用，会报Invalid repository type
真正容易被忽略的是：换源后必须删掉 composer.lock 和 vendor/，再跑一次 composer install -vvv，从日志里确认 Downloading 的 URL 是你配的镜像域名，才算真正生效。
