composer metadata加载慢的根本原因是未正确配置镜像源，必须执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/、清缓存并验证日志中packages.json路径是否含镜像域名。
Composer metadata加载慢，90%是因为还在直连 packagist.org —— 换镜像不是“能快一点”，而是“不换就根本走不动”。
为什么 composer install 卡在 “Loading composer repositories” 或 “Reading packages.json”？
这不是网络差，是 Composer 在拉取元数据（packages.json、provider-lists）时，默认硬编码请求 https://packagist.org/packages.json。这个请求受 DNS 污染、TLS 握手慢、CDN 路由绕行三重拖累，尤其在容器、CI 或企业内网中，经常卡住 30 秒以上甚至超时。
关键点：镜像必须同时覆盖元数据接口和 ZIP 包分发节点，否则会报 Package not found 或 Signature mismatch。
- 执行
composer install -vvv，最后一行如果还出现https://packagist.org/packages.json，说明镜像根本没生效 - 哪怕你写了镜像地址，但没清缓存，Composer 仍优先读本地旧缓存里的海外索引
- 项目级
composer.json中的repositories字段会完全覆盖全局配置，容易被忽略
怎么确认 repo.packagist 镜像真的生效了？
只运行一条命令不够，必须三步闭环验证：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 且含"url": "https://mirrors.aliyun.com/composer/"（注意末尾斜杠 ✅，https://mirrors.aliyun.com/composer❌） - 立刻执行
composer clear-cache—— 否则缓存里还是 packagist.org 的 packages.json，请求根本不会发出去 - 跑一次
composer install -vvv，日志里要看到类似Reading packages.json from cache at /home/user/.composer/cache/repo/https---mirrors-aliyun-com-composer/packages.json
常见失败原因：repos.packagist（多写一个 s）、漏掉 composer 类型参数、用了 HTTP 地址（Composer ≥2.2 默认拒绝）、或配置进了项目而非全局（忘了 -g）。
parallel-downloads 设多少才真有用？
这个参数只对 composer install 有效，且依赖镜像是否支持 HTTP/2 多路复用。阿里云、清华、腾讯镜像都支持，但私有源若不支持，设再高也白搭。
- 默认值是
3，基本等于没开；推荐设为10：composer config -g parallel-downloads 10 - 别盲目冲到
20：低配 CI 或企业网络容易触发file_put_contents(): failed to open stream（临时文件竞争） - 必须先确认版本：
composer --version输出 ≥2.2；若是 1.x，先composer self-update - 它对
composer update无效——那个阶段仍是串行依赖解析
哪些操作会让镜像“形同虚设”？
即使镜像地址写对了、缓存也清了，以下几类配置仍会绕过镜像：
-
composer.json里写了"prefer-source": true：它会强制走 Git clone，跳过所有 dist 镜像 - 某些包硬编码 GitHub URL，例如
"dist": {"url": "https://github.com/xxx/yyy/archive/..."}：这类请求直接撞 GitHub Rate Limit，报错含GithubRateLimitException - 项目级
repositories数组里手动加了"packagist.org": false：这会禁用基础包源，导致monolog/monolog等核心包拉不到 - 公司内网拦截 HTTPS 重定向，需临时加
--secure-http=false（仅调试，不推荐长期启用）
最常被忽略的其实是缓存路径本身：如果 ~/.composer/cache 在机械硬盘或加密卷上，解压 ZIP 包时 I/O 就成瓶颈。可挪到 SSD：composer config -g cache-dir /path/to/ssd/composer-cache。
