composer不支持自动切换镜像源，必须通过外部脚本实现；config --global repo.packagist不生效因键名、type参数、url格式三者缺一不可；ci中应使用curl探测+composer_home隔离配置，禁用测速插件。
composer 本身不支持自动探测网络并切换镜像源，所谓“自动切换”必须由外部脚本控制，不能依赖 composer 自带逻辑。
为什么 config --global repo.packagist 不生效？
很多人执行 composer config --global repo.packagist https://mirrors.aliyun.com/composer/ 后发现 install 还走官方源，根本原因是三个硬性条件缺一不可：
-
repo.packagist键名必须是单数（不是repos.packagist或packagist.org） -
composer必须作为type参数显式传入（漏掉就 fallback 到默认源） - URL 必须以
https://开头、末尾带/（少斜杠会拼出/composerpackages.json导致 404）
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 JSON；再跑 composer show -p | head -3，第一行域名要匹配你设的镜像。
CI 中如何实现主备探测 + 切源？
靠 composer config 动态改配置在 CI 中常失效，因为缓存复用、Docker 层未清理、或旧 ~/.composer/config.json 残留。真正可控的做法是纯 shell 探测 + 环境隔离：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
curl -sI https://mirrors.aliyun.com/composer/ | head -n1 | grep "200 OK"检查阿里云是否可用 - 失败则试腾讯云：
curl -sI https://mirrors.cloud.tencent.com/composer/ | head -n1 | grep "200 OK" - 探测成功后，用
COMPOSER_HOME=/tmp/composer-home-$$ composer -d /path/to/project install启动 - 加
--no-plugins防插件篡改源，COMPOSER_NO_INTERACTION=1避免交互阻塞
项目级配置怎么避免覆盖私有源？
进项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会尝试合并进 composer.json 的 repositories 字段。但前提是原 repositories 是对象格式（如 "repositories": { "packagist": {} }），不是数组——否则直接报错。
- 已有
"repositories": []或"repositories": {}时，命令能安全 merge - 若已是数组，就得手动转成对象再操作
- 更关键的是：
"packagist.org": false必须写在composer.json根节点，否则即使配了镜像，也会先卡 30 秒请求官方源
禁用“自动测速”插件
网上有些脚本依赖 composer-plugin-speed-test 类插件做自动选源，但这类插件测速不准，且忽略同步延迟与网络策略（比如 DNS 被污染但 HTTP 可通），实际切错源反而导致 Package not found。
真实环境里，镜像的可用性 ≠ 响应快慢。阿里云和腾讯云都稳定，中科大同步延迟略高，华为云路径含 /repository/php/ 易写错——与其让脚本猜，不如用 shell 纯做 HTTP HEAD 探活，再结合 COMPOSER_HOME 隔离配置。
