全局镜像配置需严格满足三点：repo.packagist（单数）、type为composer、URL以/结尾；验证须见完整JSON输出；项目级repositories字段会覆盖全局配置且不提示。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，但漏掉任意一个细节都会静默失败——不是没反应，是根本没写进去。
为什么 composer config -g repo.packagist 总是“看起来成功，实际没用”
这条命令不报错、不提示、也不回滚，但 composer install 依然卡在 Loading composer repositories。真正原因只有三个：
-
repo.packagist必须是单数形式，写成repos.packagist或packagist.org会静默忽略 - 中间的
composer是 type 值，不是可选参数，也不能省略或替换成package等其他字符串 - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，少斜杠会拼出错误路径如/composerpackages.json，导致 404 或 fallback 到官方源
怎么确认镜像真的写进去了
别信“命令跑完就 OK”，必须验证输出：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果返回空、
null、Key not found，或者还是https://packagist.org，说明配置根本没写成功 - 额外验证：运行
composer diagnose，看Repo.packagist.org这一行是否显示你的镜像地址
项目里有 repositories 字段，全局配置还管用吗
完全不管用。Composer 的仓库优先级是硬编码的：项目 composer.json 中的 repositories > 全局 ~/.composer/config.json > 默认源。
- 哪怕只写了
"repositories": []，也会让全局镜像失效，且不报错 - 快速排查：运行
grep -A3 '"repositories"' composer.json，检查是否硬编码了packagist.org或空数组 - 临时绕过项目配置验证镜像：加
--repository-url=https://mirrors.aliyun.com/composer/参数，例如composer update --repository-url=https://mirrors.aliyun.com/composer/
换源后还是卡住？清缓存和旧文件才是关键
镜像只加速下载环节，但 Composer 会优先读取本地缓存和 composer.lock 中记录的元数据地址。即使你刚配好镜像，它也可能还在用旧 URL。
- 先运行
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再执行
composer install -vvv，观察日志里是否出现mirrors.aliyun.com - 如果日志里仍有
packagist.org，说明某处配置仍被覆盖，回到上一步检查composer.json里的repositories
最容易被忽略的是：项目级 repositories 字段的存在本身就会让全局配置失效，而且 Composer 不会警告你。很多人反复重试全局命令，却没意识到问题出在自己项目的 composer.json 里。
