Composer 不支持多线程下载，其默认串行处理 dist 包；所谓“并发问题”实为插件冲突、缓存争抢或超时设置不当所致；真正有效方案是换镜像、调超时、清缓存并隔离 CI 缓存目录。
Composer 本身不支持多线程下载
这是最容易被误解的一点：Composer 没有 --parallel、-j 或类似 make -j 的并发下载开关。它默认是串行拉取 dist 包（ZIP/TAR），每个包的下载、校验、解压都是单任务顺序执行。所谓“多线程出错”，实际是以下几种情况之一：
- 你启用了第三方插件（如
hirak/prestissimo）——该插件已废弃且与 Composer 2.2+ 不兼容，强行启用会导致cURL error 6、SSL read: errno=0或静默失败 - 你在 CI 环境中误配了
COMPOSER_PROCESS_TIMEOUT=0+ 高并发 job，导致多个composer install实例争抢缓存目录或临时文件锁 - 你手动设置了
"config": {"fxp-asset": { ... }}（旧版 fxp/composer-asset-plugin），它会启动子进程并行下载 Bower/NPM 包，但早已停止维护，与现代 Composer 冲突
“下载卡住/失败”本质是 HTTP 或进程超时，不是并发问题
报错里出现 The process "git clone ..." exceeded the timeout 或反复重试 Downloading https://...，说明触发的是 process-timeout 或 http.timeout 限制，和线程数无关。真正影响速度和稳定性的参数只有三个：
-
http.timeout：控制单次 HTTPS 请求总耗时（DNS + TLS + 首字节 + body 传输），默认 300 秒；弱网下建议设为600或1200 -
process-timeout：控制git clone、unzip等外部命令最长运行时间，与 HTTP 无关，默认 300 秒；大项目建议设为1800 -
http-basic-timeout（Composer 2.2+）：单独控制 HTTP 连接建立和首字节等待，比http.timeout更细粒度，默认仅 60 秒；国内镜像不稳定时可提至240
调高它们不会带来并发，但能避免因网络抖动被过早中断。
真正提升下载效率的方法只有换源 + 清缓存
比起折腾不存在的“多线程”，下面三步组合拳解决 95% 的下载失败：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 composer https://mirrors.aliyun.com/composer/ - 清空损坏缓存：
composer clear-cache（尤其当报Content-Length mismatch时必须做） - 加重试机制：
composer install --retry=3（注意不是--retries）
镜像源本身是 CDN 加速，天然具备多节点分发能力；Composer 只需按序请求，就能获得接近并发的吞吐效果。硬上代理或自建多线程 downloader 反而容易触发 CDN 限流或 TLS 握手冲突。
CI 环境要特别注意缓存目录隔离
在 GitHub Actions、GitLab CI 等场景下，多个 job 共享同一台 runner 时，若都用默认缓存路径 ~/.composer/cache，会出现：
- 一个 job 正在写
files/vendor/name/hash.zip，另一个 job 同时读 —— 校验失败 - 两个 job 并发执行
clear-cache—— 缓存被清空一半 - 未设
COMPOSER_CACHE_DIR，不同 job 覆盖彼此的repo缓存
正确做法是每个 job 独立缓存目录：COMPOSER_CACHE_DIR=/tmp/composer-cache-$RUNNER_ID，再配合 composer install --no-interaction --prefer-dist。
别被“多线程”字眼带偏——Composer 的瓶颈从来不在并发能力，而在网络鲁棒性和缓存一致性。把镜像、超时、缓存这三件事盯死，比任何插件都管用。
