Composer本身不支持自动镜像切换，因其无fallback机制；重复配置同类型镜像源会报Invalid repository type错误；主备切换必须依赖外部脚本或环境变量控制，如用curl探测后通过COMPOSER_REPO_PACKAGIST动态设置。
Composer 本身不支持自动镜像切换
它没有 fallback、mirror_of 或轮询机制。你在 repositories 数组里写两个 {"type": "composer", "url": ".../composer/"}，会直接报 Invalid repository type —— 因为 Composer 认为 packagist 是全局唯一源，重复声明同类型就拒绝加载。
所谓“自动切换”都是外部实现的，比如 shell 脚本探测 + 环境变量注入，或者 CI 中预设多套配置。Composer 自身只做一件事：用当前生效的那个源，尽最大努力下载（含重试、dist/source 切换、断点续传），但不会主动换源。
- 它能自动从
dist切到source，也能重试超时请求，但这和“换镜像”无关 -
repositories.packagist.org是单值字段，不是数组，没法塞多个 URL - 项目级
composer.json里只要定义了repositories，全局配置就完全失效，连 fallback 都没机会触发
怎么让镜像切换真正生效
关键不在“配多少个”，而在“谁在起作用”。必须确认三处一致：
查配置：composer config -g repositories.packagist.org 输出必须是完整 JSON，且 url 值是你设的镜像地址（结尾带 /）
看诊断：composer diagnose 找 “Repo:” 行，域名要匹配
抓真实请求：composer show -p | head -3 第一行显示的源域名要是你配的；更准的是加 -vvv 跑一次 composer update，日志里 Downloading 的 URL 应含 mirrors.aliyun.com 或对应地址
- 漏执行
composer clear-cache，旧元数据还在本地，请求照发旧地址 - Windows 下 Git Bash 可能读
%APPDATA%\Composer\config.json，而非~/.composer/config.json，--global写错位置了 - Composer 2.2+ 已弃用
repo.packagist，改用repositories.packagist.org；用旧键名可能被静默忽略
临时切源比永久配置更可靠
尤其在 CI、调试、或帮别人跑命令时，硬改全局配置容易污染环境，也难追溯问题。推荐用环境变量临时指定：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
COMPOSER_REPO_PACKAGIST=https://mirrors.cloud.tencent.com/composer/ composer install
腾讯云镜像默认开启回源（找不到包时自动 fallback 到 packagist.org），阿里云不回源——如果你常装新发布或小众包，优先选腾讯云地址
- 单次命令指定镜像：
composer create-project laravel/laravel myapp -r https://mirrors.ustc.edu.cn/composer/ - 仅当前项目生效（不进
composer.json）：composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/ - 别用
composer config -g mirror，这个键名根本不存在，官方不识别
真需要主备逻辑？自己写脚本控制
把探测封装成可复用的逻辑，比如检查 https://mirrors.aliyun.com/composer/packages.json 是否返回 200，失败则 fallback 到腾讯云，再设环境变量：
if curl -sfI https://mirrors.aliyun.com/composer/ >/dev/null; then export COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/; else export COMPOSER_REPO_PACKAGIST=https://mirrors.cloud.tencent.com/composer/; fi
这种方案干净、可测试、不依赖 Composer 版本，也避免插件权限收紧带来的兼容问题（Composer 2.2+ 对插件调用时机做了限制，create-project 等早期阶段甚至不加载插件）
最常被忽略的一点：95% 的“镜像不可用”其实是本地 DNS 解析失败或代理干扰，脚本里加一句 dig mirrors.aliyun.com +short 或 curl -v https://mirrors.aliyun.com/composer/ 才能分清是源的问题，还是你本地网络的问题
