Composer按repositories数组从上到下线性扫描，首个返回有效元数据的源即生效，后续全跳过；必须将私有源置顶、显式设{"packagist.org": false}于其后，且镜像URL须完整、type必须为"composer"。
repositories数组顺序就是实际优先级，不是“轮询”
Composer根本不会轮询多个镜像源——它只按repositories数组从上到下线性扫描，第一个返回有效元数据（HTTP 200 + 合法 JSON + 包信息不为空）的源就锁定使用，后续全部跳过。所谓“多源容错”，仅在遇到明确404时才触发下一个；遇到超时、502、DNS失败等，直接报错退出，根本不会查第二个源。
常见误操作是把阿里云和清华镜像并列写进数组，指望自动 fallback。结果阿里云响应慢但没超时，Composer 就卡满默认 30 秒，完全不碰清华镜像。
- 必须把响应最快、同步最稳的镜像放在数组第一位（如
https://mirrors.aliyun.com/composer/） - 私有源必须置顶，否则镜像先返回
404就直接失败，私有包根本没机会被识别 -
"type": "composer"和完整 URL（末尾带/）缺一不可，否则composer update直接报Invalid repository type
“快速失败”靠的是显式禁用 packagist.org，不是靠删源
即使你把镜像放第一位，只要没写{"packagist.org": false}，Composer 仍会把官方源当兜底：镜像返回404（比如新包还没同步），它立刻切过去，导致你以为“优先级失效”。这个开关必须作为独立对象写在repositories数组末尾，不能嵌套、不能漏引号、不能写成"packagist"或"packagist.com"。
- 错误写法：
"repositories": [{"type":"composer","url":"..."},{"packagist.org":false}]→ 位置对但少了type和url字段，会被当作无效仓库解析失败 - 正确写法：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}, {"packagist.org": false} - 项目级配置会整块覆盖全局配置，哪怕全局设了镜像，只要项目
composer.json里有"repositories"字段，就得重配一遍
真要 fallback，得用插件或代理，别硬塞 repositories
硬塞多个composer类型镜像进repositories，只会让元数据混乱、安装变慢，甚至因版本冲突报Package x is not available。Composer 本身不支持主备切换逻辑，下载阶段完全不走 fallback 流程。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
想实现自动故障转移，只有两条路：
- 装
yunwuxin/composer-plugin-mirror插件，它接管下载逻辑，在 ZIP 下载失败时按配置顺序重试镜像地址 - 用本地代理服务（如
composer-proxy），把所有请求统一转发给一个带健康检查和重试能力的网关 - 别信
curl -I脚本切换方案——它只能切 config，但composer.lock里记录的是旧源 hash，换源后composer install仍可能校验失败
最容易被忽略的同步延迟和元数据缺失
镜像快 ≠ 包全。新包发布后几分钟内查不到，不是你配置错了，而是镜像服务还没拉取完成。更隐蔽的是：国内镜像不托管完整的packages.json快照，只同步 ZIP 和部分索引。如果根索引没及时更新，Composer 请求/packages.json就会漏掉新包，连404都收不到，直接卡住。
验证是否真用了镜像，别看命令输出，运行：composer config repositories，确认输出里只有你的镜像 URL，且没有"packagist.org": true这类残留。删vendor和composer.lock再重装，才能彻底清掉旧源残留影响。
