composer不支持多镜像自动切换或主备fallback，因其repo.packagist为单值字段，多次config -g会覆盖而非叠加；真fallback需在composer.json中显式声明repositories数组、设"packagist.org": false，并按顺序配置源。
Composer 不支持“多镜像自动切换”或“主备 fallback”这种开箱即用的能力。你配再多 URL，只要没按规则写进 repositories 数组并关掉默认源，就只是摆设。
为什么 composer config -g repo.packagist 写两次根本没用
这条命令操作的是单值字段：repo.packagist 对应 JSON 里一个字符串，后一次执行必然覆盖前一次。比如：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ composer config -g repo.packagist https://mirrors.tencent.com/composer/
第二行直接把第一行干掉了。这不是 bug，是设计如此。
- 想切镜像？只能手动换，每次换完建议跑
composer clear-cache - 别信网上那些用
sed往config.json里硬塞多个 URL 的脚本——Composer 加载时只读第一个repo.packagist字段 - 全局配置（
~/.composer/config.json）会被项目级composer.json中的repositories完全覆盖，不是合并
repositories 数组怎么写才真能 fallback
只有显式声明多个 type: "composer" 源，并关闭默认源，才能让 Composer 按顺序查包。关键结构长这样：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{ "type": "composer", "url": "https://mirrors.aliyun.com/composer/" },
{ "type": "composer", "url": "https://packagist.org/" }
],
"packagist.org": false
}
注意三点：
-
"packagist.org": false必须写在根节点，不能塞进repositories里，否则 Composer 还会偷偷连官方源 - 顺序 = 优先级：阿里云放前面，官方源放后面；但官方源只在阿里云返回
404（包确实不存在）时才触发，不是超时或502就切 - 所有自定义源都必须带
"type": "composer"和完整 URL，缺一不可，否则composer update直接报Invalid repository type
为什么配了双源，composer install 还卡 30 秒
因为 Composer 默认等待单个源超时 30 秒才尝试下一个。它不是“失败即切”，而是“等满才切”。DNS 慢、TLS 握手失败、镜像服务端卡住，都会拖满这 30 秒。
- 临时验证是否走镜像：加
-vvv参数，看日志里请求的是不是你配的镜像域名 - 避免卡死：全局设长超时
composer config -g http.timeout 600 - 更治本：加环境变量
COMPOSER_IPV4=1强制走 IPv4，绕过 IPv6 fallback 延迟 - 别指望靠堆镜像数量提升稳定性——真正影响体验的，是是否关默认源、是否强制 IPv4、是否调高超时
私有包 + 公共镜像混用时容易漏包
Composer 对每个包名只查第一个能响应的源。如果你的私有包和公共包同名（比如都叫 utils/helper），而私有源排在后面，就会被跳过。
- 私有源必须放在
repositories数组最前面，确保优先匹配 - 避免给私有包起和 Packagist 上已存在包相同的名字，哪怕版本号不同——Composer 不按版本筛选源，只按包名路由
- 调试时加
-vvv，看日志里是否出现你私有源的 URL 请求；如果完全没出现，说明它被跳过了 - 私有源若用
"type": "vcs"或"type": "package"，不受公共镜像逻辑影响，但也要确保 URL 可访问、响应格式正确
最常被忽略的一点：镜像只影响下载行为，不影响 composer.lock 内容。如果 lock 文件里记的是官方源的 hash，换镜像也没用——得删掉 vendor 和 composer.lock，再重新 install。
