composer 2.2+才支持parallel-downloads，需全局配置且配合--prefer-dist、国内镜像及禁用钩子才能显著提速；并发过高易触发临时文件竞争或限流，需依环境调优。
parallel-downloads 配置没生效？先确认 Composer 版本和当前值
Composer 2.2+ 才真正支持 parallel-downloads，低于此版本设了也白搭。执行 composer --version 看输出是否为 2.2.x 或更高。旧版必须先升级：composer self-update --prefer-dist。
查当前并发数：composer config -g parallel-downloads。默认是 3，基本等于没开；输出为空说明未启用。全局设为 10 是多数机器的安全上限：composer config -g parallel-downloads 10。
常见错误现象：
- 加了配置但
composer install还是卡在 “Downloading xxx” —— 很可能是版本太低，或配置写到了项目级composer.json而非全局（-g缺失） - 并发设到
20后报file_put_contents(/tmp/): failed to open stream—— 临时文件竞争，立刻降到6或8
--prefer-dist 不是可选项，是提速前提
--prefer-dist 强制走预打包的 ZIP/TAR 包，跳过 Git clone、checkout、submodule 等高开销操作。它和 parallel-downloads 是咬合关系：没有 --prefer-dist，并行下载的只是大体积源码包，解压和校验反而更慢。
实操建议：
- 全局启用：
composer config -g prefer-dist true（开发机慎用，会干扰你直接改vendor/里的源码） - CI/CD 中必须显式加：
composer install --prefer-dist --no-dev --optimize-autoloader - 若项目里已有
"prefer-source": true，prefer-dist不会覆盖它——得手动删掉该配置项 - 私有包只提供 source 地址时，
--prefer-dist会失败，报错类似Could not find a matching version of package xxx
镜像源 + 并发 + 关钩子，三者缺一不可
只换镜像不启并发，或只启并发不换源，效果都打折扣。国内镜像（如阿里云）主要缓存 dist 包，且 HTTP/2 支持更好，但并发太高会被限流。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
关键组合命令（CI 中推荐）：
composer install --prefer-dist --no-dev --no-scripts --no-autoloader --optimize-autoloader
说明：
-
--no-scripts：跳过 post-install-cmd 等钩子，避免意外触发npm install或redis flushdb -
--no-autoloader：不生成vendor/autoload.php，后续用composer dump-autoload --optimize单独补 -
--optimize-autoloader：生成 classmap，运行时不再扫描 PSR-4 目录，但本地开发别长期开着，否则新增类不自动加载
注意：--no-scripts 和 --no-autoloader 后的 vendor 不能直接跑 PHP，必须补一次 composer dump-autoload --optimize。
为什么开了并发还是卡在某个包？排查网络和文件系统瓶颈
并发下载快了，不代表整个流程就快了。常卡在两个地方：
-
DNS / TLS 握手阶段：用
strace -e trace=connect,openat -p $(pgrep -f "composer install")观察是否反复重试连接；换 DNS（如1.1.1.1）或临时关 TLS（export COMPOSER_NO_TLS=1，仅限可信内网） -
vendor 写入阶段：macOS APFS 或 Windows + 实时杀毒（如 Windows Defender）会拦截每个
file_put_contents，导致每秒写入从 120MB 掉到 8MB；临时关闭实时扫描或换 SSD 可验证 - 某些包硬编码 GitHub URL（如
"dist": {"url": "https://github.com/..."}），绕不开镜像，会撞 GitHub 403 rate limit；此时需配github-oauthToken
真正耗时的大头从来不是“下得多快”，而是“解析锁、解压、校验、写磁盘”这一整条链路上的串行阻塞——并发只是撬动其中一环，其他环节松动不了，整体还是慢。
