Composer下载慢90%因镜像源配置错误，必须严格满足键名repo.packagist、type参数、URL结尾斜杠三者全对，否则静默失效；换源后需clear-cache并验证日志确认走镜像。
Composer下载慢，90%是因为没配对镜像源，不是网络差，也不是机器卡——换源必须满足键名、type、URL结尾斜杠三者全对，否则静默失效。
composer config -g repo.packagist 命令为什么总不生效
这条命令极易“看似执行成功，实则完全没写进去”。常见静默失败原因：
-
repo.packagist写成repos.packagist（多一个 s）——Composer直接忽略，fallback回https://packagist.org - 漏掉中间的
composertype 参数：composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌，必须是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ - URL末尾缺
/：https://mirrors.aliyun.com/composer会拼接出错，返回 404；正确写法是https://mirrors.aliyun.com/composer/ - 没加
-g参数——只改当前目录下的composer.json，换项目就失效
验证是否生效：运行 composer config -g repo.packagist。输出必须是完整 URL 字符串（如 https://mirrors.aliyun.com/composer/）或 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）。空、null、或仍显示 https://packagist.org，说明根本没写进去。
换源后还是卡在 Downloading，最常被跳过的一步
镜像配置正确 ≠ 立刻加速。缓存里还存着旧源的元数据，Composer 优先读缓存，仍会尝试连 packagist.org 做校验，结果卡在 DNS 或 TLS 握手。
必须立刻执行：
-
composer clear-cache—— 清掉所有本地缓存，强制重新拉取镜像站数据 - 如果项目已有
vendor/和composer.lock，建议一并删掉再跑composer install，避免残留干扰
验证是否真走镜像：运行 composer show laravel/framework -vvv 2>&1 | grep "Downloading"，日志里必须出现 mirrors.aliyun.com 或对应镜像域名，不能只看命令有没有报错。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
项目级配置比全局更稳妥的三个场景
全局配置方便，但容易被覆盖或引发协作问题。以下情况推荐进项目根目录，用不带 -g 的命令：
- 团队协作项目：配置随
composer.json提交，新人 clone 后开箱即用，行为一致 - CI/CD 构建环境：容器每次启动都读取最新配置，不用额外写部署脚本配全局
- 同时维护多个项目，且部分项目依赖私有源：用
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/会自动向repositories数组追加条目，不覆盖已有私有仓库
注意：如果 composer.json 已有 "repositories": []，手动编辑易格式出错；务必用命令追加，而非直接改 JSON。
阿里云、腾讯云、清华源怎么选
三者同步频率和 CDN 覆盖略有差异，选哪个取决于你的实际网络表现：
- 阿里云
https://mirrors.aliyun.com/composer/：同步最快（通常 5 分钟内），适合装新发布包（如当天 tag） - 腾讯云
https://mirrors.cloud.tencent.com/composer/：CDN 节点广，某些地区延迟更低，稳定性好 - 清华源
https://mirrors.tuna.tsinghua.edu.cn/composer/：教育网友好，对 IPv6 支持更成熟
别迷信“默认推荐”，真正有效的镜像是你本地 -vvv 日志里能稳定看到请求发到的那个域名。同一台机器上可轮换试一次 composer show symfony/console -vvv，观察哪个响应快、不超时。
换源只是第一步，真正卡在 Resolving dependencies 阶段时，跟镜像无关——那是 Composer 在本地穷举版本组合，得查 PHP 内存、Xdebug、platform 配置和 composer.lock 状态。这点最容易被忽略，却常被当成“镜像没用”。
