Composer不支持多镜像自动fallback，需手动配置或脚本探测；全局配置需满足-g、repo.packagist键名、HTTPS带/三条件，项目级配置更可靠但格式要求严格，切换后必须clear-cache。
Composer 不支持“多个镜像源自动 fallback”，所谓“多源”必须靠手动切换或脚本探测实现——它没有内置的优先级轮询、故障转移或健康检查机制。
composer config -g repo.packagist 为什么总不生效
命令静默失败，不是网络问题，而是三个硬性条件任一不满足就回退到官方源：
- 漏掉
-g：不加就是改当前项目composer.json，换目录即失效 - 键名写错：必须是
repo.packagist（单数、全小写、无s），repos.packagist或packagist.org都存进无效字段 - URL 格式错误：必须 HTTPS 开头、末尾带
/，比如https://mirrors.aliyun.com/composer/；少斜杠会拼成/composerpackages.json导致 404
验证是否成功：执行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明没配进去。
项目级配置比全局更可靠，但要注意格式陷阱
团队协作或 CI 环境中，全局配置易被权限、用户或缓存干扰；项目级配置可 Git 跟踪、行为确定。进项目根目录后执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会往 composer.json 的 repositories 字段里写入一个名为 packagist 的条目，但前提是原 repositories 是对象（如 {"packagist": {}}），不是数组。如果是数组，命令直接失败，需先手动转成对象格式。
注意：type 必须是 composer，url 末尾不能有斜杠（和全局配置相反）——https://mirrors.tuna.tsinghua.edu.cn/composer ✅，https://mirrors.tuna.tsinghua.edu.cn/composer/ ❌，否则某些版本报 Invalid repository type。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
想“主备切换”，得自己写脚本探测，别指望 Composer
Composer 不会在超时、502、DNS 失败时自动跳下一个镜像——它只对明确的 404 做 fallback。所以“阿里云挂了切腾讯云”这种需求，必须靠外部逻辑控制：
- 用
curl -I -s -o /dev/null -w "%{http_code}" https://mirrors.aliyun.com/composer/packages.json检查返回是否为200 - 根据结果动态执行
composer config -g repo.packagist切地址 - 切换后必须执行
composer clear-cache，否则旧镜像的元数据可能残留导致后续 404
别把 repositories 数组当成“多镜像开关”——它本质是包路由表，顺序即匹配优先级，但仅对 404 生效；超时卡住 30 秒就报错，根本不会往下试。
repositories 数组里加多个 composer 源会出问题
强行在 repositories 里并列写两个 {"type": "composer", "url": "..."} ，会导致：
- Composer 认为类型冲突，加载失败或报
Invalid repository type - 依赖解析异常：同一包在不同镜像中版本不一致，Composer 无法仲裁
- 安装变慢：每个源都要单独请求元数据，且不共享缓存
真正安全的多源策略是：只保留一个镜像作为主源（如阿里云），再在 repositories 数组末尾加 {"packagist": true} 来兜底元数据（即 packages.json 索引），确保新包能被发现；ZIP 包仍从你设的第一镜像下载。别写 {"type": "composer", "url": "https://packagist.org/"}，那会失去镜像加速意义。
最常被忽略的点：所有镜像配置都绕不开缓存。哪怕命令执行成功、日志显示 URL 正确，如果 ~/.composer/cache 里还存着旧 DNS 解析或过期元数据，composer update 仍可能走错路径。每次切换镜像后，clear-cache 不是可选项，是必做动作。
