命令写对了，必须同时满足三要素：键名repo.packagist（单数）、type值composer、URL为HTTPS且末尾带/，否则静默失效；验证需输出完整JSON对象。
composer config -g repo.packagist 命令到底写对没？
90% 的镜像配置失败，不是网络问题，是这条命令静默失效——不报错、不提醒，但根本没写进去。
必须同时满足三个硬条件：
-
repo.packagist不能写成repos.packagist（多一个 s 就彻底忽略） - 必须显式带上
composer这个 type 参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅；漏掉composer就 fallback 到官方源 ❌ - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅；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，说明没生效。
换源后还是卡在 “Resolving dependencies”？镜像压根不负责这事
镜像只加速下载环节（Downloading、Fetching package），完全不参与依赖求解。这个阶段卡住，和网络无关，是本地约束爆炸导致的。
典型诱因：
-
"php": "^7.4 || ^8.0 || ^8.1"这类宽泛约束，让求解器暴力尝试所有组合 -
"minimum-stability": "dev"强制拉取不稳定分支，候选版本数指数级增长 -
composer.lock被删或未提交，install实际退化为update - 项目
composer.json中repositories指向了已下线私有源，Composer 逐个超时才 fallback
快速排查：进项目根目录，执行 composer config --list | grep repositories 看实际生效源；再跑 composer validate --strict 确认 lock 文件合法。
parallel-downloads 设多少才真起作用？
parallel-downloads 是 Composer 2.2+ 原生机制，只对 composer install 有效，composer update 仍需串行算依赖图。默认值是 3，基本等于没开。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
推荐设为 10：composer config -g parallel-downloads 10
但别盲目冲到 20：
- 企业网络或低配 CI 容易触发
file_put_contents(): failed to open stream（临时文件竞争），降到 6–8 更稳 - 该参数依赖镜像支持 HTTP/2 多路复用；阿里云、清华、腾讯镜像都支持，但私有源若不支持，设高了也白搭
- 运行
composer --version确认是 2.2+；若是 1.x，先composer self-update
为什么加了 --prefer-dist 还卡在 downloading？
--prefer-dist 的作用是跳过 git clone，直接下 ZIP 包。但它有个硬前提：镜像必须已生效。
国内镜像（如阿里云）几乎不缓存 source，只缓存 dist —— 镜像没切成功，--prefer-dist 就会 fallback 到慢速 source，甚至失败。
必须同步执行 composer clear-cache，否则缓存里还存着旧的 packages.json，Composer 会继续按旧地址拉校验信息。
还要检查项目 composer.json 是否含 "prefer-source": true，它会覆盖全局 --prefer-dist，必须手动删掉。
某些包硬编码 GitHub URL（比如 "dist": {"url": "https://github.com/xxx/yyy/archive/..."}），这类不会走镜像，会撞上 GitHub Rate Limit；报错含 GithubRateLimitException 就是它。
