Composer无内置镜像优先级机制，所谓优先级实为手动控制repositories数组顺序：靠前的源先查，首个返回有效元数据即用，后续全跳过；禁用packagist.org需显式配置{"packagist.org": false}并补入镜像作为普通仓库。
Composer 没有“镜像优先级”这个内置机制——你配置的多个 repositories，只是按数组顺序线性查找，第一个返回有效包元数据（不是超时、500 或 404）的源就直接用，后面的全跳过。所谓“优先级”，本质是手动控制 repositories 数组里各项的位置和开关状态。
怎么让阿里云镜像真正生效，而不是连不上 packagist.org 就报错
常见错误：在 composer.json 里同时写了 packagist.org 和阿里云镜像，结果一断网就卡在 Could not fetch https://packagist.org/packages.json。这是因为 Composer 默认把 packagist.org 当作隐式兜底源，且它总在最前——除非你显式禁用。
- 全局配置镜像，必须用
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/（注意 key 是repos.packagist，不是repo.packagist） - 项目级配置更可靠：直接在
composer.json的repositories数组里写镜像，并把{"packagist.org": false}放在最后作为开关 - 千万别把
https://repo.packagist.org/和镜像 URL 同时塞进repositories——前者会抢在镜像前触发网络请求，失败即中断 - 验证是否生效：运行
composer config repositories，确认输出中只出现你的镜像 URL，且packagist.org显示为false
多个镜像源（如阿里云 + 腾讯云）能自动 fallback 吗
不能。Composer 不支持故障转移、轮询或健康检查。它只按 repositories 数组顺序查，且仅当某个源明确返回 404（包不存在）时，才继续查下一个；遇到超时、500、DNS 失败等，直接报错退出。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 想“模拟 fallback”，得靠脚本检测镜像可用性再切换：
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json返回200才设为当前源 - 两个镜像都写进
repositories数组没意义——只要第一个镜像服务正常，第二个永远不被访问 - 国内镜像本质是 packagist.org 的只读代理，不托管私有包；混配私有源时，必须禁用默认源，否则私有包会被跳过
- 响应速度差异真实存在：阿里云通常比腾讯云快，所以把阿里云放数组第一位，腾讯云放第二位（仅作备用），但别指望它真能 fallback
私有仓库 + 镜像共存时，怎么确保私有包走私仓、公共包走镜像
关键不是“怎么让 Composer 分流”，而是“怎么让它只查该查的源”。Composer 不会自动识别包归属，它只看每个 repository 是否声明支持该包名。
- 私有仓库必须用
"type": "composer"（别用package或vcs），并确保其packages.json包含你要的包（或支持通配符匹配） - 顺序必须是：私有源 → 镜像源 →
{"packagist.org": false}（禁用开关） - 如果私有源没在
packages.json里声明myorg/utils，Composer 就不会去查它，哪怕它排第一 - 项目级
composer.json中的repositories会完全覆盖全局配置，所以别依赖全局镜像——要把镜像 URL 也复制进项目配置里 - 调试时加
-vvv参数执行composer require myorg/utils，看日志里实际请求了哪个源的packages.json
为什么改了 repositories 但 composer install 没反应
composer install 只读 composer.lock，不重新解析源。如果你新增了私有源或换了镜像，但 lock 文件里记录的还是旧源地址，那安装过程根本不会触发新源查询。
- 必须运行
composer update --lock（推荐）或删掉composer.lock再composer install - 私有包首次 require 后，lock 文件会固化其来源；后续即使你把私有源从
repositories里删了，install仍能成功——因为源信息已锁死 - 如果私有源需要认证（HTTP Basic/OAuth），确保
auth.json已配置，否则update会卡在401 Unauthorized - type 为
vcs的仓库无法被索引，每次require都要远程探测 tag，性能差且不可控，不建议用于多源优先级场景
最常被忽略的一点：禁用 packagist.org 后，你必须手动把它作为普通仓库加回来（放在数组末尾），否则连 monolog/monolog 这种基础包都会找不到——Composer 不再有隐式兜底逻辑。
