Composer 不支持多镜像自动切换或优先级 fallback，全局配置 repo.packagist 仅为单值字段，多次设置会覆盖而非追加；项目级配置需显式声明且受全局配置影响，镜像仅替换元数据源，不代理 dist/source 原始链接。
Composer 不支持“多镜像源自动切换”或“镜像优先级顺序”——它每次只用一个 repo.packagist.org 的替代源，所谓“配置多个镜像”，本质是手动切换，不是同时启用。
为什么 composer config -g repo.packagist 只能设一个镜像
Composer 的全局仓库配置项 repo.packagist 是单值字段，底层对应一个 RepositoryInterface 实例。你反复执行 composer config -g repo.packagist https://mirrors.aliyun.com/composer/，只会覆盖前一次设置，不会追加。
常见错误现象：
– 执行两次 composer config -g repo.packagist 后，composer show 仍只看到一个源
– 以为加了腾讯云和阿里云两个镜像就能“自动 fallback”，结果某个镜像挂了就直接报 Could not fetch packages
- 这是设计使然，不是 bug，Composer 官方明确不计划支持多源 fallback（见 GitHub issue #8729）
- 所有“多镜像脚本”都是靠 shell 层做条件判断，不是 Composer 自身能力
- 如果你在
composer.json里写多个repositories，它们只对当前项目生效，且优先级由数组顺序决定 —— 但仅限于你显式声明的私有包，不影响packagist.org公共包的下载路径
想实现“国内镜像失效时切回官方源”，得靠外部脚本控制
真实使用场景：CI/CD 流水线里要稳定拉包，又不想硬编码死一个镜像（比如阿里云临时维护）。
实操建议（以 Bash 为例）：
- 先用
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json检查镜像可用性（返回200才算活） - 根据检查结果，动态执行
composer config -g repo.packagist切换目标地址 - 注意：切换后要清空 Composer 的缓存（
composer clear-cache），否则旧镜像的元数据可能残留导致 404 - 别忘了在脚本末尾还原或记录当前生效的镜像，方便排查
示例片段：
if curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json | grep -q "200"; then composer config -g repo.packagist https://mirrors.aliyun.com/composer/ else composer config -g repo.packagist https://repo.packagist.org/ fi composer clear-cache项目级临时换源：比全局配置更安全、更可控
日常开发中，改全局配置容易污染其他项目，尤其当你同时维护需要私有包和公共包的项目时。
推荐做法：
- 用
composer config repo.packagist（不加-g）为当前项目单独设镜像，配置存在./composer.json的repositories字段下 - 这样切换不影响其他项目，
git add composer.json还能同步团队环境 - 如果项目必须混合使用私有包 + 公共包，把私有源放在
repositories数组前面，公共镜像放后面，并显式设"type": "composer"和"url" - 注意：项目级配置无法绕过全局镜像（如果全局已设），必须先
composer config -g --unset repo.packagist才能生效
最常被忽略的一点：镜像源只是替换 packages.json 和 zip 包的域名，不改变包的 dist 或 source 地址解析逻辑。也就是说，哪怕你配了国内镜像，某个包的 dist.url 如果写的是 GitHub 原始链接，Composer 依然会直连 GitHub —— 镜像对此类资源完全无效。
