直接执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/可全局生效，但ci、宝塔或docker中常因用户不一致（如root配而www用户运行）、键名拼错（如repos.packagist）、项目级repositories覆盖或未清缓存导致失效；验证需检查config输出、diagnose结果及-vvv日志中的真实请求域名。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能全局生效，90% 的本地开发场景下这是最快解法；但如果你在 CI、宝塔或 Docker 里跑命令，它大概率不生效——不是镜像问题，是配置没写到真正执行命令的那个用户目录下。
全局配置为什么有时不生效
因为 composer config -g 写的是当前用户的 ~/.composer/config.json，而实际运行 Composer 的可能是另一个用户：
- 你在终端用
root执行了命令，但宝塔后台是以www用户跑的，它读的是/home/www/.composer/config.json - GitHub Actions 默认用
runner用户，你用sudo composer config -g写进了root配置，对构建完全无效 - 拼错键名：写成
repos.packagist（多一个 s）或packagist.org，Composer 静默忽略，查composer config -g repo.packagist会返回空
项目级配置更可靠，适合协作和 CI
进项目根目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
这条命令会安全写入 composer.json 的 repositories 字段，不覆盖已有私有源。注意：
- 如果项目已有
"repositories": {}（空对象），命令会 merge 进去；如果是"repositories": []（数组），命令会报错，得先手动改成对象 - 别手写
"packagist.org": false——这等于关掉所有源，镜像一抖就彻底失败 - 改完务必删掉
vendor/和composer.lock，再跑composer install，否则旧 lock 文件里的 hash 可能和镜像元数据不匹配
验证是否真在用阿里镜像
别靠“好像快了”判断，要查实际生效的配置和网络请求：
- 运行
composer config -g repo.packagist，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 运行
composer diagnose，看 “Repo” 行是否显示阿里云地址；若仍是https://packagist.org，说明被项目级repositories覆盖了 - 跑一次
composer update -vvv，观察日志里Downloading的域名是不是mirrors.aliyun.com——这才是最终确认
最容易被忽略的一点：镜像只加速元数据拉取和 ZIP 下载，不解决 Resolving dependencies 卡顿。如果 composer update 卡在这一步，和镜像无关，该检查 composer.json 里有没有循环依赖或版本约束太松。
