如何加速Composer install命令的执行速度-composer-PHP中文网

镜像源未生效需检查json配置是否为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，常见问题包括字段名错误、缺type参数、url末尾无斜杠、项目级repositories优先级更高、ci环境未预设全局配置；--prefer-dist失效因包无dist定义或prefer-source启用；parallel-downloads=10需composer 2.2+且镜像支持http/2；wsl2须避免/mnt/c路径；提速必备--no-dev、-o、-a参数。

如何加速composer install命令的执行速度

镜像源没生效，所有加速都白搭

执行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空值、null、或仍是 https://packagist.org，说明根本没切过去。

常见失效原因：

repo.packagist 写成 repos.packagist（多一个 s）
命令漏掉 composer 类型参数：composer config -g repo.packagist composer https://...，少 composer 就 fallback 到官方源
URL 末尾缺斜杠：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（会拼出 /packages.json 导致 404）
项目级 composer.json 里写了 "repositories" 字段，它优先级高于全局配置，得删掉或改成镜像地址
CI 环境（如 GitHub Actions）每次构建都是干净环境，必须在 workflow 中提前加 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

--prefer-dist 不起作用？先看 dist 是否可用

--prefer-dist 不是魔法开关，它只在包提供 dist 信息时才生效。日志里如果还看到 Cloning https://github.com/...，说明 fallback 到了 source，速度必然慢。

触发 fallback 的典型情况：

包本身没声明 dist 字段（比如私有 GitLab 包未显式配置）
项目 composer.json 里写了 "prefer-source": true，它会覆盖全局 --prefer-dist，必须用 composer config --unset prefer-source 或手动删掉该字段
用了 path 类型依赖，例如 "monolog/monolog": {"type": "path", "url": "../monolog"}，这种必然走 source，不参与并发下载
缓存没清，旧元数据还在拉海外源，必须先跑 composer clear-cache

parallel-downloads=10 不是越高越好

这个参数只在 Composer 2.2+ 生效，低于版本设了也白搭，先用 composer --version 确认。默认值是 3，基本等于串行。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

设为 10 是多数场景的平衡点，但要注意硬约束：

镜像源必须支持 HTTP/2，否则并发请求会被排队堵死；可临时切回官方源测试：composer config -g repo.packagist composer https://packagist.org，再试 --concurrency=6
报 file_put_contents(/tmp/): failed to open stream，说明临时目录文件竞争，降到 6 或 8
某些 CI 环境（如低配 runner）磁盘 I/O 有限，盲目设高反而拖慢

WSL 和 CI 构建里最容易漏的参数

在 WSL2 里，项目绝不能放在 /mnt/c/ 下运行 composer install——NTFS 挂载层会让小文件 I/O 延迟飙升 5–10 倍。必须移到原生 ext4 分区，比如 ~/project，并用 df -T . 确认 Type 是 ext4 而非 drvfs。

CI 构建中漏掉任意一个参数，提速效果就打对折：

--no-dev：跳过 require-dev 下所有包（如 phpunit），省掉 30–60% 解析时间
--optimize-autoloader（或 -o）：生成静态类映射，PHP 7.4+ 还能进 opcache，必须开

--classmap-authoritative（或

-a）：告诉 autoloader “查不到就真没有”，跳过 PSR-4 fallback；仅用于生产或 CI，开发环境误用会导致新增类不被识别

--no-scripts：跳过 post-install-cmd 等脚本，部署时常用

真正卡住的地方往往不是网络，而是本地穷举版本组合（Resolving dependencies 阶段），它不走网络却可能耗几十秒——这时换镜像、调并发全无效，得收紧 composer.json 里的 PHP 版本约束和 dev 包范围。