优先换阿里云镜像源、升级Composer 2.x、加--prefer-dist --no-dev -o参数，可解决90%的Laravel 10安装卡顿；阿里云镜像使安装从5–10分钟降至1–2分钟，Composer 2.x提速40%–60%。
Laravel 10 安装卡住、超时，基本不是 Laravel 本身的问题，而是 Composer 下载依赖环节受网络和配置影响。核心解决方向就三个：换镜像源、升级 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
输出应为
https://mirrors.aliyun.com/composer/，而不是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 场景）
默认行为会下载源码、加载全部开发依赖、逐个解析自动加载规则——这些对部署毫无必要。
-
--prefer-dist：强制下载预编译 zip 包，比 git clone 快 3–5 倍 -
--no-dev：跳过require-dev中的包（如 phpunit、laravel/pint），减少 30%+ 依赖量 -
-o（即--optimize-autoloader）：生成类映射表，避免运行时文件查找
组合使用：
composer create-project laravel/laravel my-project --prefer-dist --no-dev -o
顺手清理缓存 & 检查环境（容易被忽略）
Composer 缓存损坏或磁盘 I/O 慢（尤其在 Docker 或 CI 环境中 /tmp 性能差），会导致“明明换了镜像还卡在 downloading”这类假性缓慢。
- 清理缓存：
composer clear-cache
- 若用 Docker，确认挂载卷性能正常；若在低配机器上，避免同时跑多个 Composer 进程。
