根本原因是键名必须为repo.packagist（单数、全小写）、type值必须显式写composer、URL必须以https://开头且末尾带/，三者缺一即静默回退官方源；验证需输出完整JSON对象。
composer config -g repo.packagist 命令为什么总不生效
根本原因就三条：键名必须是 repo.packagist（单数、全小写），type 值必须显式写成 composer，url 必须以 https:// 开头且末尾带 /。三者缺一，Composer 2.2+ 就会静默 fallback 到 https://packagist.org，不报错也不提示。
常见错误示例：
-
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/→ 键名多一个s，写进去了但不认 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 漏掉composer，直接走官方源 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer→ 缺末尾/，拼出/composerpackages.json导致 404
验证是否成功：必须运行 composer config -g repo.packagist，输出得是完整 JSON，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或只返回字符串都说明没写进去。
换镜像后还卡在 “Loading composer repositories” 怎么办
这不是网络问题，而是 Composer 仍在读旧缓存或 composer.lock 中记录的元数据地址。镜像只加速元数据拉取和 ZIP 下载，但这两者必须匹配——如果 composer.lock 里还存着 packagist.org 的 URL，它就不会走镜像。
正确操作顺序只有三步：
- 先执行
composer clear-cache清掉本地缓存 - 删掉项目下的
vendor/和composer.lock - 再跑
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或类似域名
如果日志里还是 packagist.org，说明配置或清理不到位，得回头检查键名、type、URL 格式。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
宝塔、CI、Docker 环境下镜像不生效？用户身份没对上
全局配置写在当前用户的 ~/.composer/config.json，但宝塔「一键部署」默认用 www 用户跑，CI 流水线用 runner 用户，它们根本读不到你 root 下配的镜像：
- 在宝塔终端里先执行
whoami，确认实际用户（通常是www） - 切到对应用户下重配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中别依赖全局配置，改用临时参数更可靠：
composer install --repository-url=https://mirrors.aliyun.com/composer/
别指望 sudo composer config -g 写进 root 配置后，其他用户能自动继承——Composer 不共享跨用户配置。
升级 Composer 自身时被镜像源“骗”了版本
composer self-update 默认不连 https://getcomposer.org，而是读当前配置的镜像源响应。国内镜像（如阿里云）可能缓存旧版本信息，导致终端显示 Up to date，但 composer --version 实际仍是旧版。
解决方法分两步：
- 临时切回官方源：
composer config -g repo.packagist composer https://packagist.org，再执行composer self-update - 更新完立刻换回镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
特别注意：self-update --3（升 v3）仅在 Composer ≥ 2.5+ 支持。若当前是 2.4.x，得先升到 2.5+，再加 --3；否则永远卡在 v2.x。
