composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist、第二个参数必须显式写 composer（type 值）、URL 必须 HTTPS 且末尾带 /，缺一即静默回退官方源；验证需执行该命令并确认输出为完整 JSON 对象。
composer config -g repo.packagist 命令为什么总不生效
它不是“没反应”，而是静默失败——漏掉任意一个硬性条件，Composer 就当配置不存在，直接回退到官方源，连 warning 都不报。
必须同时满足这三点：
-
repo.packagist是唯一合法键名（注意是 repo 单数，写成repos.packagist或packagist.org全部无效） - 第二个参数
composer是type值，不是注释，不能省略，也不能写成composer.org - URL 必须是 HTTPS 且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证是否真写进去了？别信终端没报错，直接运行：composer config -g repo.packagist。输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或提示 Key does not exist，说明根本没写成功。
项目级配置比全局更可靠，尤其在协作和 CI 场景
全局配置（-g）只影响当前用户的 ~/.composer/config.json，但在宝塔、GitHub Actions、Docker 容器或 Vagrant 中，PHP 进程往往以 www、runner 或其他用户身份运行，压根读不到你的配置。
推荐做法：进项目根目录（含 composer.json），执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动在 composer.json 顶层写入 "repositories" 字段，key 固定为 "packagist"，不会覆盖已有私有源。但要注意：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 如果
composer.json里已有"repositories": []（数组形式），命令会静默失败；需先手动改成"repositories": {}（空对象）再重试 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update） -
repositories字段一旦存在，就会完全屏蔽全局配置，优先级更高
换源后仍卡在 “Loading composer repositories” 怎么快速定位
这不是镜像地址问题，而是请求根本没发到你配的地址——Composer 还在用缓存或旧元数据。
排查顺序很关键：
- 先运行
composer diagnose，看Repo.packagist.org行是否显示为你配的镜像 URL - 再执行
composer clear-cache清掉本地缓存 - 检查项目
composer.json是否写了"packagist.org": false—— 这会关闭所有 fallback，镜像挂了就彻底失败 - 确认没混用
vcs类型源：所有自定义镜像都必须是"type": "composer"，漏字段或类型错误会导致Invalid repository type
如果还卡住，临时加 --no-cache 跑一次 composer update --no-cache -vvv，观察日志里实际请求的域名是不是 mirrors.aliyun.com。
别指望 Composer 自动 fallback 多个镜像
Composer 不支持主备镜像自动切换。你执行两次 composer config -g repo.packagist，后一次会直接覆盖前一次；在 composer.json 的 repositories 数组里写多个镜像，也只用于合并元数据，下载时只从第一个声明该包的源拉取——502、超时、DNS 失败都会直接中断，不会试下一个。
真要容灾，得靠外部脚本控制三步流程：探测镜像可用性 → 切换当前生效源 → 清缓存。例如 Bash 脚本中用 curl -I -s https://mirrors.aliyun.com/composer/ | grep "200 OK" 判断，再执行 composer config -g repo.packagist 动态写入。
最常被忽略的一点：哪怕你配好了镜像，只要 composer.lock 里记录的是旧源地址，composer install 就仍会按 lock 文件里的 URL 去拉包——所以删 lock 文件不是可选项，是必要动作。
