Composer安装慢的根本原因不是网络差，而是镜像未生效、本地依赖求解卡顿、Xdebug未禁用、缓存未清及并发下载未启用；需正确配置阿里云镜像、执行clear-cache、禁用Xdebug、设parallel-downloads=10并验证生效。
为什么 composer install 在中文网络下特别慢？
根本原因不是 Composer 本身不支持并发，而是默认的 curl 下载器单线程、无连接复用、且直连 packagist.org（被墙）或国内镜像（如 https://packagist.phpcomposer.com 已停用）时缺乏 HTTP/2 和长连接优化。更关键的是：Composer 2.x 虽内置了并行下载能力（通过 pool-size），但该机制仅作用于包元数据解析后的 ZIP 下载阶段，且依赖 cURL 的异步支持，而 Windows 或某些 PHP-curl 编译版本并不启用 CURLMOPT_MAXCONNECTS 或 HTTP/2，实际仍是串行排队。
Parallel-Downloader 插件真能提速吗？
能，但只在特定条件下显著——它把「下载 ZIP 包」这一步彻底从 Composer 主流程中剥离，改用独立的多进程 PHP 子进程（非多线程）+ 原生 file_get_contents 或 cURL 并发拉取，绕过 Composer 内置下载器的锁和调度瓶颈。实测在 100+ 依赖、千兆宽带环境下，下载阶段可从 3–5 分钟压缩至 40 秒左右。
- 必须使用 Composer 2.2+（插件 API 兼容性要求）
- PHP 需启用
pcntl扩展（Linux/macOS 默认常开；Windows 下基本不可用） - 镜像源必须支持 Range 请求（否则并发分块失败），阿里云、腾讯云、华为云镜像均满足
- 不要和
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/这类全局镜像配置冲突——插件会自动识别并复用当前配置的镜像地址
安装与启用 Parallel-Downloader 的关键步骤
直接全局安装插件即可生效，无需修改 composer.json：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer global require hirak/prestissimo:dev-master
⚠️ 注意：这不是官方插件，hirak/prestissimo 是早期流行方案，但已停止维护；真正适配 Composer 2.x 的是 composer-plugin-parallel-downloader（作者：clue）。正确命令是：
composer global require clue/composer-plugin-parallel-downloader:^2.0
- 安装后无需额外启用，插件自动注册为
PluginInterface - 若执行
composer install时没看到并发日志（如Downloading x packages in parallel...），检查是否启用了--no-plugins或设置了环境变量COMPOSER_DISABLE_PLUGINS=1 - 可通过
composer global show确认插件是否在列表中 - 插件默认并发数为 8，如需调整，在
composer.json中加："config": {"parallel-downloader": {"max-jobs": 12}}
比加速更值得盯住的三个坑
插件解决的是「下载快」，但慢的根源常在别处：
-
autoload dump阶段卡顿：大量 PSR-4 映射 + 深层嵌套目录时，composer dump-autoload --optimize可能比下载还耗时，建议开发期禁用优化："config": {"optimize-autoloader": false} - 镜像源未真正生效：运行
composer config -l | grep -i repo，确认repos.packagist.url指向的是https://mirrors.aliyun.com/composer/而非原始域名 - 插件与某些自定义 installer 冲突：如项目用了
composer/installersv2.2.0 以下版本，可能因事件监听顺序导致 ZIP 解压失败，升级到^2.2可规避
并发下载只是链条上的一环，漏掉 autoload 或镜像配置，再快的下载也白搭。
