parallel-downloads设8～10为多数linux/macos稳定上限，windows建议≤6；需配合clear-cache验证，且对composer update无效。
换镜像不能解决并发请求失败——它只改下载地址，不改并发逻辑。真正卡住的不是“连不上”，而是 Composer 自身的并发控制、镜像源限流、临时文件竞争和 fallback 机制在批量依赖场景下集体失效。
parallel-downloads 设多少才不崩
Composer 2.2+ 的 parallel-downloads 默认是 3，设太高反而触发系统级失败：
• 常见报错 file_put_contents(/tmp/): failed to open stream 是并发写临时文件冲突，不是磁盘满
• 全局设成 20 几乎必出问题；8～10 是多数 Linux/macOS 环境的稳定上限
• Windows 下建议 ≤6，因 %TEMP% 路径权限和清理策略更激进
• 必须配合 composer clear-cache 再测，否则旧缓存会绕过并发路径
镜像源本身是否支持高并发
阿里云、腾讯云等主流镜像虽标称“高可用”，但实际对单 IP 的并发连接数有限制：
• 用 curl -I https://mirrors.aliyun.com/composer/packages.json 看 X-RateLimit-Remaining 头可粗略判断
• 若日志中反复出现 503 Service Temporarily Unavailable，大概率是被限流，不是你配错了
• 此时降 parallel-downloads 到 4～6，比硬扛更有效
• 不要迷信“多线程=快”：HTTP/1.1 下并发 10 个请求 = 10 次 TLS 握手 + DNS 查询，开销远超收益
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
为什么 --prefer-dist 在大批量时反而失败
--prefer-dist 强制走 ZIP 包，但大批量场景下暴露两个隐藏问题：
• 私有包或老旧包没提供 dist 地址，Composer 会 fallback 到 source（即 git clone），而 git 操作无法并行，瞬间卡死
• 镜像源只同步 packages.json 和 dist ZIP，不托管 git refs；一旦 dist 缺失，就会退到 packagist.org 拉 source，触发跨域重试
• 解法：在 composer.json 中局部禁用："preferred-install": {"my-org/*": "source"}，避免全局 fallback
项目级 repositories 会彻底关闭 parallel-downloads
只要 composer.json 里有 "repositories" 字段（哪怕空数组），Composer 就：
• 忽略全局 repo.packagist 配置
• 关闭 parallel-downloads 机制（文档未明说，但实测行为如此）
• 强制串行解析每个仓库的元数据
• 验证方式：删掉 repositories 后跑 composer install -vvv，看日志是否出现 Downloading (10) 这类并发标识
• 如果必须用私有源，优先走 repositories.packagist.org 的 mirror 方式，而非自定义 repositories
最常被忽略的一点：大批量失败往往发生在 composer update，但 parallel-downloads 对它完全无效——SAT 依赖求解天生串行。此时换镜像、调并发，都是在修水管，而问题出在水塔。先锁版本、删 require-dev、缩小 minimum-stability 范围，比调参数管用得多。
