直接执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可生效，但必须严格满足三个硬性条件：键名repo.packagist（非repos.packagist）、composer为必填type值、URL末尾带/，缺一即静默回退官方源；验证需输出完整JSON对象，且项目级配置优先级高于全局。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，但漏掉任意一个细节都会静默失败——不是没反应，而是根本没切过去。
为什么 composer config -g repo.packagist 总是不生效
它不报错，但也不起作用，90% 是因为三个硬性条件缺一不可：
-
repo.packagist键名不能写成repos.packagist（多一个s就被忽略） - 中间的
composer是type值，不是注释或可选参数，省略后 Composer 2.0+ 会 fallback 到官方源 -
https://mirrors.aliyun.com/composer/必须带末尾斜杠，少斜杠会拼出/composerpackages.json导致 404
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON。空、null、或仍是 https://packagist.org，说明没成功。
全局配置 vs 项目级配置：谁优先？谁更可靠？
全局配置写入 ~/.composer/config.json（Windows 是 %USERPROFILE%\AppData\Roaming\Composer\config.json），所有项目默认读它；但项目级配置写在当前项目的 composer.json 的 repositories 字段里，优先级更高——哪怕你刚配好全局，只要 composer.json 里有 repositories，就会被覆盖且不报错。
适合场景：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 个人开发机用全局：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI/CD 或团队协作时用项目级：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g，确保在项目根目录下运行） - 宝塔、Docker 等多用户环境，先确认执行用户（比如
whoami），再针对性配置，例如：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换源后还是卡在 Loading composer repositories 怎么办
镜像本身没问题，卡顿往往来自缓存或残留元数据：
- 先清缓存：
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 加
-vvv重试：composer install -vvv，看日志里请求域名是不是mirrors.aliyun.com - 旧版 Composer 1.x 不识别
repo.packagist，得用：composer config -g repos.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}'
注意：某些企业防火墙会拦截 HTTPS 请求，临时可试 HTTP（仅限内网可信环境）：http://mirrors.aliyun.com/composer/；但 Composer 2.5+ 默认拒绝 HTTP，需降级或调整策略。
哪些镜像地址现在还能用（2026 年 7 月实测）
截至今日，以下三个镜像全量同步、HTTPS 强制、延迟稳定（5 分钟内），其余旧地址基本不可靠：
- 阿里云：
https://mirrors.aliyun.com/composer/（华北快，华东偶发 502） - 腾讯云：
https://mirrors.cloud.tencent.com/composer/（CDN 覆盖广，南方稳定） - 华为云：
https://mirrors.huaweicloud.com/repository/php/（全量含历史版本，同步延迟最低）
绝对不要用：https://packagist.phpcomposer.com（2023 年已下线）、https://packagist.laravel-china.org（2026 年起同步不稳定）、任何 http:// 开头地址（Composer 2.5+ 强制 HTTPS）。
最易被忽略的点：换源后不清理 composer.lock 和缓存，Composer 仍按旧元数据地址拉取——它不会自动刷新已记录的包来源，必须手动干预。
