Composer不支持多镜像自动fallback，因repo.packagist为单值字段，后设URL覆盖前设；可靠切换仅两种：全局配置后清缓存，或项目级repositories显式覆盖。
Composer 本身不支持多镜像自动 fallback，所谓“灵活切换”必须靠手动干预配置 + 显式清缓存，否则看似切了，实际请求仍走旧源或官方源。
为什么 composer config -g repo.packagist 不能写多个地址
这个配置项在 ~/.composer/config.json 中是单值字段，硬编码只认 repo.packagist（单数、全小写、无 s），你执行两次：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
后一条会直接覆盖前一条。任何试图用 jq 或手动编辑塞数组进去的做法，都会导致 composer diagnose 报错 Repo is not configured properly。
真能“切换”的只有两种可靠方式
没有中间态，只有明确的主源切换或项目级覆盖：
- 全局主源切换：用
composer config -g repo.packagist覆盖写入新 URL，再立刻执行composer clear-cache—— 缓存不清，元数据仍指向旧源，等于白配 - 项目级锁定：进项目目录后去掉
-g，运行composer config repo.packagist composer https://xxx/，它会把源写进当前composer.json的repositories字段，优先级高于全局配置 - 临时单次使用：用
--repository参数，如composer update --repository=https://packagist.mirrors.ustc.edu.cn，该参数不改任何配置，只影响本次命令
不同镜像 URL 的关键细节差异
不是复制粘贴就能用，URL 格式错一个字符就 404 或连接失败：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 阿里云、腾讯云、中科大、清华新源（
packagist.mirrors.ustc.edu.cn）都必须以/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌ - 华为云路径含子目录：
https://mirrors.huaweicloud.com/repository/php/composer/，少/repository/php/就 404 - 所有 URL 必须带
composertype 值，命令里漏掉这个字，比如写成composer config -g repo.packagist https://xxx/，Composer 2.1+ 会静默忽略整条配置 - 清华旧镜像
https://packagist.phpcomposer.com已下线，继续用会报cURL error 60或Could not resolve host
验证是否真的生效，别信“好像快了”
只看安装速度或 composer config -g repo.packagist 输出 JSON 不够，必须交叉验证三处：
- 运行
composer config -g repo.packagist，输出必须是完整对象，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；若为空、null或报Key not found，说明没写成功 - 运行
composer diagnose，看 “Repo” 行显示的 URL 是否匹配你设的镜像域名；若仍是https://packagist.org，大概率被项目composer.json里的repositories字段屏蔽了 - 执行
composer update -vvv，日志中首次请求的packages.json地址必须是镜像域名，例如Downloading https://mirrors.aliyun.com/composer/packages.json；如果出现packagist.org或github.com，说明镜像没接管元数据层
最常被忽略的是：项目级 repositories 一旦存在，全局配置就完全失效，且 Composer 不提示、不警告——你得自己去 grep -A 5 "repositories" composer.json 检查。
