直接换镜像源+升级composer 2.x+启用--prefer-dist --no-dev -o参数,可解决90%的laravel安装卡顿问题;阿里云镜像使安装从5–10分钟降至1–2分钟,composer 2.x提升40%–60%速度,优化参数进一步加速依赖下载与类加载。

直接换镜像源 + 升级 Composer 2.x + 启用优化参数,能解决 90% 的 Laravel 安装卡顿问题。不是 Laravel 本身慢,是 Composer 下载和类加载环节拖了后腿。
换国内镜像源(最立竿见影)
Packagist 官方源在国内直连极不稳定,经常超时或限速。阿里云、腾讯云镜像已稳定运行多年,切换后 composer create-project laravel/laravel 命令通常能从 5–10 分钟降到 1–2 分钟。
- 全局切换(推荐):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 仅当前项目切换:
composer config repo.packagist composer https://mirrors.tencent.com/composer/ - 验证是否生效:
composer config repo.packagist应返回镜像地址,不是https://packagist.org
必须升级到 Composer 2.x
Composer 1.x 是单线程下载、无并行解析,而 2.x 默认启用多线程下载和更优的依赖图算法。Laravel 9+ 已完全适配,且官方早已停止维护 1.x。不升级,其他优化效果打七折。
- 检查版本:
composer --version—— 若显示1.x,立刻升级 - 升级命令(Linux/macOS):
curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer - Windows 用户直接下载
Composer-Setup.exe(官网最新版默认为 2.x) - 升级后
composer install耗时通常下降 40%–60%
安装时加关键参数(生产/CI 场景必加)
默认 composer install 会下载源码(source)、加载全部开发依赖、逐个解析自动加载规则——这些对部署毫无必要。
-
--prefer-dist:强制下载预编译的 zip 包,比 git clone 快 3–5 倍 -
--no-dev:跳过require-dev中的包(如phpunit,laravel/pint),减少 30%+ 依赖量 -
--optimize-autoloader(可简写为-o):生成vendor/composer/autoload_classmap.php,避免运行时文件查找 - 组合使用:
composer install --prefer-dist --no-dev -o
清理缓存 & 检查本地环境(容易被忽略的瓶颈)
Composer 缓存损坏或磁盘 I/O 慢会导致“明明换了镜像还卡在 downloading”这类假性缓慢。尤其在 CI/CD 或 Docker 环境中,/tmp 或挂载卷性能差会放大问题。
- 清包缓存:
composer clear-cache(清除~/.composer/cache/files/) - 清元数据缓存:
rm -rf ~/.composer/cache/repo/(有时比clear-cache更彻底) - Docker 构建时避免
vendor/挂载到慢盘;Laradock 用户注意workspace容器的/var/www是否绑定到机械硬盘 - 内存不足也会拖慢 Composer 解析:确保至少 2GB 可用内存,
composer update时建议 4GB+
真正卡住的时候,先跑 composer diagnose,它会指出镜像是否失效、缓存是否损坏、PHP 扩展是否缺失(比如没开 zlib 就解不了 dist 包)。别急着重装 Laravel,95% 的“安装慢”其实发生在 Composer 层。











