Composer 不支持自动切换镜像源，所有主备切换必须由外部脚本或 CI 控制；配置 repo.packagist 生效需同时满足键名单数、type 为 composer、URL 以 https:// 开头且结尾带 / 三个条件。
Composer 本身不支持自动切换镜像源，所谓“全球化自动 fallback”是常见误解。它没有内置的备用源探测、健康检查或轮询逻辑；所有“主备切换”都必须由外部脚本或 CI 环境控制，否则一旦配置的镜像不可用，就会卡住或报错。
为什么 composer config -g repo.packagist 配了也不生效？
三个硬性条件缺一不可，漏一个就静默失败：
-
repo.packagist键名必须是单数repo（不是repos、repositories或packagist.org）——Composer 2.x 内部硬编码只认这个 key - type 值必须显式写
composer，不能省略，也不能写成composer-type或注释 - URL 必须以
https://开头且末尾带/，例如https://mirrors.aliyun.com/composer/；少斜杠会拼成/composerpackages.json导致 404
验证方式只有两个：运行 composer config -g repo.packagist 看输出是否为完整 JSON；再跑 composer show -p | head -3，第一行域名是否匹配你设的镜像。
项目级配置比全局更可控，但要注意格式陷阱
进项目根目录执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会自动在 composer.json 的 repositories 字段里安全合并。但前提是原 repositories 是对象（如 "repositories": { "packagist": {} }），不是数组。如果已经是数组，命令会直接报错，必须手动转成对象格式再操作。
项目级配置会被 Git 跟踪，新人拉代码后行为一致；但若项目中已有 "packagist.org": false 或空 "repositories": []，就会完全屏蔽全局设置，导致切源无效。
真要实现“自动切换”，只能靠外部脚本探测
Composer 不提供任何 fallback 机制，但你可以用 shell 脚本模拟：
- 先用
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json检查阿里云是否返回 200 - 失败则换腾讯云：
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.cloud.tencent.com/composer/packages.json - 探测成功后，用
composer config -g repo.packagist composer $URL动态写入 - CI 中建议把这步封装成预处理任务，避免每次
composer install都卡在慢源上
注意：Windows 下 Git Bash 可能读取 %APPDATA%\Composer\config.json 而非 ~/.composer/config.json，脚本里要适配路径。
最易被忽略的一点：Composer 2.2+ 已弃用 repo.packagist 以外的旧键名（如 packagist），且不再兼容 HTTP 源；哪怕镜像地址拼写全对，只要协议不是 HTTPS 或版本低于 2.2，依然会静默回退到官方源。
