直接改composer.json不是好办法，因为项目级repositories会完全覆盖全局配置、易被composer update覆盖、新成员clone后易遗漏、CI环境默认不读取，导致镜像失效；应统一用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/全局配置。
为什么直接改 composer.json 不是好办法
团队里有人手动在项目根目录的 composer.json 里加 repositories 镜像配置，看似简单，实则埋雷：每次 composer update 都可能覆盖掉它；新成员 clone 项目后忘记配，直接走官方源卡死；CI 构建时因环境差异失效。这不是配置，是补丁。
真正该动的是 Composer 的全局行为，而不是每个项目反复 patch。
用 composer config 全局设镜像才靠谱
执行这条命令一次，所有后续项目自动走国内源：
composer config -g repo.packagist composer https://packagist.phpcomposer.com
注意三点：
-
-g表示 global，写入~/.composer/config.json，不是当前项目 - 地址选稳定、维护中的镜像，比如
https://packagist.phpcomposer.com或https://mirrors.aliyun.com/composer/（阿里云镜像需确认是否仍支持 HTTP 协议，部分新版 Composer 要求 HTTPS） - 如果已存在自定义源，这条命令会覆盖掉原来的
repo.packagist配置，不会叠加
CI/CD 环境下必须显式重置镜像
很多 CI（如 GitHub Actions、GitLab CI）默认不加载用户全局配置，composer config -g 在构建机上无效。这时得在脚本里主动设：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/
常见坑：
- 某些 CI 镜像自带 Composer 缓存，但没配镜像，导致首次安装慢得像没配一样
- 用
docker run --rm -v $(pwd):/app -w /app composer:latest这类方式时，宿主机的 global config 不生效，必须在容器内单独执行config --global - GitHub Actions 中若用
composer/installeraction，默认不启用镜像，得加composer-config-repo参数
怎么验证镜像真生效了
别只看 composer install 快了——那可能是缓存骗你。执行这个命令看真实请求源：
composer diagnose -v | grep "Repo packagist"
输出应类似：Repo packagist: composer [https://mirrors.aliyun.com/composer/]。如果显示 packagist.org 或空值，说明没生效。
再补一手：运行 composer clear-cache 后装一个新包（比如 composer require symfony/var-dumper），观察下载域名是不是镜像地址。DNS 解析、HTTP 302 跳转、证书链异常都会让镜像“形同虚设”，光配 URL 不等于真通。
团队推广最难的不是命令怎么敲，而是让所有人理解：镜像不是“加速开关”，而是一条必须对齐的网络路径。漏掉 CI、本地全局配置权限问题、或误信“已配置”却不验证，比不配更危险。
