composer镜像配置必须同时满足三个硬性条件才生效：键名严格为repo.packagist、type值显式写composer、url以https://开头且末尾带/，任一缺失即静默回退官方源；项目级配置更可靠，需执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/并运行composer update --lock更新lock文件。
直接换镜像就能解决 Composer 下载慢的问题，但 90% 的人配不成功——不是网络被墙，是 composer config -g repo.packagist 命令漏了三个硬性条件，导致静默 fallback 到官方源。
为什么 composer config -g repo.packagist 没生效
这条命令不报错、不提示，但只要缺以下任意一项，Composer 就自动退回到 https://packagist.org：
-
repo.packagist是唯一合法键名（不能写成repos.packagist、packagist.org或mirror） - 中间的
composer是必需的type值，不是注释，也不能省略或替换成 URL -
url必须是 HTTPS 且末尾带/，例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404 ❌
验证是否真写进去了，只看这一行：composer config -g repo.packagist。输出必须是完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null、报 Key not found，说明根本没配进去。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级配置比全局更可靠
全局配置在宝塔、Docker、GitHub Actions 等场景下大概率失效，因为这些环境常以 www 或 runner 用户运行，读不到你本地 ~/.composer/config.json。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 该命令会自动识别
composer.json中的repositories结构：如果是对象，就写入"packagist"键；如果是数组，就追加新项，不破坏已有私有源 - 改完立刻执行：
composer update --lock，否则composer.lock里仍记录的是旧源地址 - 切忌手动写
"packagist.org": false—— 这会彻底关掉回退机制，镜像临时挂了就直接失败
换源后还卡在 “Loading composer repositories” 怎么办
这不是镜像没配好，而是 Composer 优先读缓存和 composer.lock 里记的老地址。必须清干净再重试：
- 先运行：
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再执行：
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或对应镜像域名 - 如果仍请求
packagist.org，检查composer.json是否存在"packagist.org": false或"repositories": []数组结构（该命令无法安全追加，需先转为对象）
最易被忽略的一点：镜像只加速元数据拉取和 ZIP 包下载，不解决 Resolving dependencies 卡顿。如果卡在这一步，问题出在 composer.json 的 PHP 版本约束太宽、dev 分支依赖太多，或 require-dev 工具链臃肿——换任何镜像都无效。
