composer换镜像源需严格满足三个条件：键名必须为repo.packagist、type值显式设为composer、url须为https且末尾带/；否则配置静默失效；dns缓存或项目级repositories字段覆盖亦会导致失败。
换镜像源不是“试试看”，而是国内 Composer 使用的启动门槛——不配，composer install 卡在 Loading composer repositories 是常态，不是你网差，是默认直连 packagist.org 根本不通。
为什么 composer config -g repo.packagist 总是配不生效
根本原因就三个硬性条件没对齐：键名必须是 repo.packagist（不是 repos.packagist），type 值必须显式写 composer，URL 必须是 HTTPS 且末尾带 /。错一个，配置就静默失效，还不报错。
-
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/→ 多了个s，完全无效 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 缺composer类型声明，旧版 fallback 到官方源 -
composer config -g repo.packagist composer http://mirrors.aliyun.com/composer/→ HTTP 被 Composer 2.0+ 默认拒绝
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错都说明没写进去。
换了镜像还是卡在 Loading composer repositories
大概率不是 DNS 慢，而是 PHP 的 cURL 复用 DNS 缓存，导致 mirrors.aliyun.com 仍被解析到海外 IP。不用改系统 DNS，加环境变量强制跳过缓存即可：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时生效：
COMPOSER_NO_INTERACTION=1 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Docker 构建中必须提前在
Dockerfile里执行该命令，否则每次构建都重新走海外解析 - 快速验证：加
-vvv参数，如果日志里显示连的是https://packagist.org或超长延迟的 IP，基本可确认是 DNS 缓存问题
parallel-downloads 设多少才合适
Composer 2.2+ 才原生支持并发下载，默认值仅 3，根本不够用。查当前值：composer config -g parallel-downloads；如果不是 10 或更高，就补上：composer config -g parallel-downloads 15。
- 别设成
20：高并发可能触发file_put_contents(/tmp/): failed to open stream错误 - 企业网络敏感时，降回
6–8更稳 - 已装过
hirak/prestissimo的必须卸载：composer global remove hirak/prestissimo，它在 2.x 中已失效，甚至会静默降级为单线程
镜像地址本身失效或同步滞后怎么办
阿里云镜像目前最稳（分钟级同步、CDN 节点多），但若遇到 404 或 503，优先排查是否是镜像自身问题：
- 错误现象如：
[Composer\Downloader\TransportException] The "https://mirrors.aliyun.com/composer/p2/topthink/framework/6.0.0.0-alpha1.json" file could not be downloaded (HTTP/2 404) - 原因通常是镜像未同步新版本，尤其是
alpha/beta版本或刚发布的包 - 临时换源验证：
composer install -vvv --repository=https://mirrors.tuna.tsinghua.edu.cn/composer/（注意用--repository，不是--repository-url） - 华为云地址含路径
/repository/php/，手误漏掉就会 404；腾讯云偶尔有同步延迟，不建议用于生产环境
真正容易被忽略的是：项目级 repositories 字段会覆盖全局镜像，哪怕只写了一行 "packagist": false，也会让整个镜像逻辑失效——查 composer config -l | grep repositories 比猜更可靠。
