必须全局切换阿里云镜像源并清缓存，执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/且URL末尾带斜杠，再运行composer clear-cache；镜像仅加速dist包下载，不解决依赖解析或autoload卡顿问题。
没配中文镜像，composer install 很大概率根本跑不通；配对了，依赖安装从 5 分钟压到 15 秒以内——这不是提速，是让命令能执行下去的基本条件。
为什么composer install卡在 Downloading 不是网络问题，而是源没生效
现象：进度条停在某个包的 Downloading 阶段，反复重试，最终超时或报 Connection timed out、SSL certificate problem。很多人以为是自己网络差，其实只是 repo.packagist 配置静默失败，Composer 自动 fallback 到 https://packagist.org，然后直连国外源。
-
repo.packagist写成repos.packagist（多一个 s）→ 完全忽略，不报错 - 漏掉中间的
composertype 值 → 当作普通仓库处理，元数据仍发往官方源 -
url少了末尾斜杠，比如写成https://mirrors.aliyun.com/composer→ 实际请求路径拼成/composerpackages.json，404 后静默降级 - Windows 用户改完没重启终端，或 Linux/macOS 下用
sudo执行 → 配置写进了 root 的文件，但 PHP 进程以普通用户运行，读不到
验证镜像是否真在用，别信 composer diagnose
composer diagnose 只检查语法和本地连通性，不验证镜像 URL 是否被实际调用。真正有效的验证方式只有三个：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null、或只返回字符串，说明根本没写进去 - 加
-vvv参数跑一次安装：composer install -vvv 2>&1 | grep "GET https"，看实际发出的请求域名是不是镜像地址 - 临时指定源验证：
composer show laravel/framework --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/，能快速列出版本即证明镜像可用
项目级配置比全局更可靠，尤其在 CI 和协作中
全局配置（composer config -g）写在 ~/.config/composer/config.json，所有项目共享——但在宝塔、Docker、GitHub Actions 等环境里，默认以 www 或 runner 用户运行，它根本读不到你本地用户的配置。
- 进项目根目录，执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不带-g） - 这条命令会自动在
composer.json的repositories字段里添加或更新"packagist"条目，不会覆盖已有私有源 - 如果项目已有
"repositories": []数组结构，命令会追加新项；若原为对象{}，会自动转为标准数组格式 - 改完后必须删掉
vendor/和composer.lock，再跑composer install——因为lock文件里存的是旧 dist URL，不重建就不会走新镜像
composer install 卡在 Resolving dependencies？那和镜像无关
镜像源只加速下载，不参与依赖解析。这个阶段卡住，常见原因有：
-
composer.json中 PHP 版本约束太宽，例如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"，求解器穷举组合耗时剧增 - 设了
"minimum-stability": "dev"，强制拉取 dev 分支，候选版本爆炸式增长 -
composer.lock被删或未提交，install实际退化为update，重新解析整个依赖图 -
repositories字段指向了已下线的私有源，Composer 逐个超时才 fallback，拖慢整体流程
真正影响开发效率的，是“能不能装上”，而不是“解析快不快”。镜像解决的是前者——只要没配对，哪怕解析再快，最后一步下载照样失败。这也是为什么很多新人花半天配环境，卡点永远在 downloading，而不是 resolving。
