Composer不支持自动镜像切换，config -g repo.packagist失效主因是键名错误（须单数）、被项目级repositories字段覆盖或未清缓存；验证需查配置输出、diagnose结果及实际请求URL。
Composer 本身不支持自动镜像切换，也没有 fallback、mirror_of 或轮询机制。所谓“故障自动切换”，全是外部脚本或运行时干预实现的，不是 Composer 自己的行为。
composer config -g repo.packagist 为什么没生效
最常见原因就三个：键名写错、被项目级配置覆盖、缓存没清。
-
repo.packagist是单数，写成repos.packagist或repositories.packagist.org（在旧版中）都会静默失败 - 只要项目根目录
composer.json里有"repositories"字段（哪怕空数组），全局配置就完全失效 - 改完不执行
composer clear-cache，本地元数据仍指向旧源，请求照发packagist.org - Windows 下 Git Bash 可能读
%APPDATA%\Composer\config.json，而非~/.composer/config.json，-g写的位置不对
怎么验证镜像源真正在用
不能只信 composer config 的输出，得看三处是否一致：
- 查配置：
composer config -g repo.packagist输出必须是完整 JSON，且url值是你设的镜像地址（结尾带/） - 看诊断：
composer diagnose找 “Repo:” 行，域名必须匹配你配的镜像 - 抓真实请求：
composer show -p | head -3第一行显示的源域名要是你刚配的；更准的是加-vvv跑一次composer update，日志里Downloading的 URL 应含mirrors.aliyun.com或对应地址
临时切源比永久配置更可靠
尤其在 CI、调试、或帮别人跑命令时，硬改全局配置容易污染环境，也难追溯问题。
- 单次命令指定源：
composer create-project laravel/laravel myapp -r https://mirrors.aliyun.com/composer/ - 仅当前项目生效（不写进
composer.json）：composer config repo.packagist composer https://mirrors.ustc.edu.cn/composer/ - 完全绕过所有配置强制走某地址：
composer install -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/composer/，适合快速验证镜像可用性
关键点始终是：URL 必须以 / 结尾，type 值必须显式写 composer，且 repo.packagist 这个 key 一个字母都不能错——错一点就静默失效，连报错都没有。
