composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/是唯一可靠方式，因Composer 2.x+仅识别该单数键名、强制要求type值和尾斜杠HTTPS URL，缺一即静默失效。
直接用 composer config -g repo.packagist 就够了，不需要额外工具 —— 所有“Composer 源管理工具”本质都是对这条命令的包装，反而增加出错概率。
为什么 composer config -g repo.packagist 是唯一可靠入口
Composer 2.x+ 的镜像源逻辑非常明确：全局默认源只认 repo.packagist 这一个键名（单数、无 s、大小写敏感），且必须同时指定 type: "composer" 和带尾斜杠的 HTTPS URL。任何第三方工具若没严格遵循这三点，就等于白配。
- 写成
repos.packagist或repositories.packagist→ 静默写入无效字段，composer config -g repo.packagist查出来是空或null - 漏掉
composer类型参数 → Composer 2.0+ 自动 fallback 到官方源，不报错也不提示 - URL 缺末尾
/→ 请求路径拼成/composerpackages.json，直接 404，卡在Downloading - 用 HTTP 地址 → Composer 2.x 默认拒绝，报
Invalid repository type
composer config 命令三要素缺一不可
这条命令不是“建议写法”，而是硬性要求：
-
-g：必须加，否则只改当前项目composer.json，换目录就失效 -
repo.packagist：键名不能拼错，不能多 s，不能少repo.前缀 -
composer https://mirrors.aliyun.com/composer/：中间的composer是 type 值，不是注释；URL 必须 HTTPS + 末尾/
正确示例：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
错误示例：composer config -g repos.packagist https://mirrors.aliyun.com/composer（多 s、缺 type、缺 /）
项目级配置比全局更可控，尤其要提交到 Git
团队协作或 CI/CD 场景下，全局配置反而容易引发不一致问题：宝塔面板可能以 www 用户运行，GitLab Runner 可能用 gitlab-runner 用户，各自读取不同 ~/.composer/config.json。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
composer.json的repositories字段里安全合并"packagist"条目，不覆盖已有私有源 - 前提是原
repositories是对象（如"repositories": { "packagist": {} }），不是数组；如果是数组，命令会失败，需先手动转为对象 - 这个配置会被 Git 跟踪，新人拉代码后
composer install自动走镜像，composer.lockhash 也一致
临时验证镜像是否生效，别信“已配置”提示
很多工具执行完就显示“切换成功”，但实际根本没生效。真验证只看两处：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON 对象，形如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 运行
composer diagnose，检查 “Repo:” 行是否匹配你设的镜像地址 - 想确认某次命令到底连了谁？加
-vvv参数：composer install -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/，日志里会打印真实请求 URL
最容易被忽略的是：项目根目录下存在 composer.json 且含 "repositories" 字段时，全局配置完全失效 —— 这不是 bug，是 Composer 明确设计的优先级规则。
