Composer镜像源切换失效主因是配置未真正生效，而非镜像宕机；关键需同时满足：-g参数、单数键名repo.packagist、type值为composer且URL以https://开头并结尾带/，任一缺失即静默回退官方源。
直接切阿里云镜像源最稳，但composer config -g repo.packagist命令九成失败不是网络问题，是漏了-g、写错键名、或 URL 少了末尾/——这三处任意一个出错，都不报错，只静默走官方源。
为什么composer config -g repo.packagist总不生效
Composer 2.2+ 内部硬编码只识别repo.packagist（单数、全小写、无s），写成repos.packagist或packagist.org会存进无效字段，配置完全被忽略。更关键的是，这条命令必须带齐三个不可省略的部分：
-
-g：缺它就只改当前项目composer.json，换目录即失效 -
repo.packagist：键名拼错一个字母或大小写，就等于没配 -
composer https://mirrors.aliyun.com/composer/：中间的composer是type值，不是注释；URL 必须 HTTPS 开头且以/结尾，否则请求路径拼成/composerpackages.json直接 404
验证是否真写进去了？运行composer config -g repo.packagist。输出必须是完整 JSON 对象，比如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报错，都说明失败。
项目级配置比全局更可靠的实际原因
全局配置看着省事，但在 CI 流水线、宝塔面板、多项目混用时极易出问题——镜像不一致会导致composer.lock的 hash 不同、部署失败。项目级配置才是团队协作的正确姿势：
- 进项目根目录后执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 它会自动向
composer.json的"repositories"字段写入"packagist"子项，不覆盖已有私有源 - 前提是原
"repositories"是对象（如{"packagist": {}}），不是数组；如果是数组，命令会报错，需先手动转格式 - 提交
composer.json到 Git，新人拉代码后行为完全一致
换源后首次composer install若报 hash 不匹配，删掉vendor/和composer.lock重来。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
测速对比和 fallback 行为怎么验证
镜像源只加速“下载”，不解决“解析”问题。如果你的composer update卡在Resolving dependencies阶段几十秒不动，和镜像完全无关，常见真实诱因是宽泛的 PHP 版本约束或未锁定的 dev 工具链。
要确认是否真走镜像，别靠感觉，用-vvv看日志：
- 临时调试：运行
composer update -vvv --repository=https://mirrors.cloud.tencent.com/composer/，日志第一行会显示实际下载 URL - 日常验证：执行
composer clear-cache后再跑composer install -vvv，搜索日志里是否有mirrors.aliyun.com或对应镜像域名 - 注意 fallback：Composer 2.2+ 默认开启 fallback，当镜像返回 404 或 503 时，会自动切回
packagist.org查一次。所以你看到日志里偶尔出现packagist.org的 URL，不等于镜像没生效
华为云、腾讯云等非阿里镜像的地址写法差异
不同镜像地址格式差异明显，尤其华为云路径含/repository/php/，不能直接套用阿里云模板。所有 URL 必须以/结尾，且显式声明type为composer：
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/ - 中科大（备选）：
composer config -g repo.packagist composer https://packagist.mirrors.ustc.edu.cn/
清华旧镜像https://packagist.phpcomposer.com已下线，继续用会报Could not resolve host或cURL error 60。别用http://开头——Composer 2.x 默认禁用非 HTTPS 源；也别加/packages.json后缀，那是 Composer 自己拼的。
