直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能全局生效，但 90% 失败源于漏 -g、键名写成 repos.packagist 或 URL 缺末尾 /，任一错误均静默回退官方源；验证需三处一致：config 输出、diagnose 显示、-vvv 日志均为镜像地址。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能全局生效，但 90% 的失败不是网络问题，是命令漏掉 -g、键名写成 repos.packagist、或 URL 缺末尾 / —— 三者任一出错，Composer 都静默 fallback 到官方源，且完全不报错。
为什么 composer config -g repo.packagist 总不生效？
不是命令没运行，而是 Composer 2.x 硬编码只认 repo.packagist（单数、全小写、无 s），写错就存进无效字段，查出来是空或 null：
-
repos.packagist、packagist.org、Repo.Packagist全部无效 - 漏掉
composer这个 type 值 → fallback 到packagist.org，等于白配 - URL 是
https://mirrors.aliyun.com/composer（缺/）→ 请求路径拼成/composerpackages.json，直接 404 - 没加
-g→ 只改当前项目composer.json，换目录就失效
验证是否成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。
Composer 2.2+ 推荐用 repositories.packagist.org 键名
旧键名 repo.packagist 在部分新版中会被静默忽略，尤其 CI 环境或宝塔面板下更易踩坑。兼容性更强的写法是：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 设阿里云：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - 设腾讯云：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}' - 恢复官方源：
composer config -g --unset repositories.packagist.org
注意：value 必须是合法 JSON 字符串（单引号包裹整个 JSON，内部双引号不能省），否则会报 JSON decode error。
项目级配置比全局更可靠，怎么安全追加？
团队协作或 CI 场景下，全局配置容易被覆盖或权限错位（比如宝塔用 www 用户跑命令，但 -g 写的是 root 的配置）。推荐进项目根目录后执行：
-
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 它会自动 merge 到
composer.json的"repositories"字段中，key 固定为"packagist" - 前提：原
"repositories"是对象格式（如{"packagist": {}}），不是数组；如果是数组，命令会失败，需先手动转成对象 - 提交
composer.json到 Git，新人拉代码后composer install自动走镜像，composer.lockhash 一致
换源后必须执行 composer clear-cache
缓存不清理，元数据仍从旧源加载，导致 composer install 看似走新地址，实则请求发往旧域名。验证是否真生效，不能只信命令回显，要看三处：
-
composer config -g repo.packagist.url或composer config -g repositories.packagist.org输出是否为你设的镜像地址 -
composer diagnose中 “Repo:” 行显示的域名是否匹配 -
composer update -vvv日志里Downloading的 URL 是否含mirrors.aliyun.com
最常被忽略的是：composer.lock 里记录的是原始 packagist.org 的 dist URL，首次切换后建议加 --lock 强刷一次，或删掉 vendor/ 和 composer.lock 重装。
