Laravel安装慢主因是Composer默认连接境外packagist.org受网络影响,换阿里云镜像源可显著提速;需确保全局配置命令末尾含斜杠、清缓存并验证生效,项目级临时换源需配合删composer.lock,laravel/installer卡住多因GitHub API限流而非镜像问题。

Laravel安装慢,多数情况不是框架本身的问题,而是 Composer 默认从境外 packagist.org 拉包受网络影响。换用阿里云镜像源能显著提速,但操作细节容易出错——比如漏掉 URL 末尾斜杠、混淆全局与项目级配置、或误判卡顿真实原因。
全局换源:一劳永逸,所有项目生效
执行这条命令即可覆盖默认源:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意:末尾斜杠 / 不可省略,否则后续运行会报 Could not parse version constraint 错误。换源后建议清缓存:
- composer clear-cache(可选但推荐)
- 验证是否生效:composer config -g repo.packagist,输出应为包含
"url": "https://mirrors.aliyun.com/composer/"的 JSON 对象
项目级临时换源:适合 CI 或多镜像测试
不改动全局设置,仅本次命令生效,适合 GitHub Actions、Docker 构建或对比不同镜像表现:
composer install -vvv --repository-url=https://mirrors.aliyun.com/composer/
这个参数优先级最高,不会写入 composer.json 或 composer.lock。但要注意:
- 若项目已有
composer.lock,且其中记录的是 packagist.org 的哈希值,直接换源可能失败 - 此时建议先删掉
composer.lock,再执行带--repository-url的命令
laravel/installer 卡住?别急着换镜像
执行 composer create-project laravel/laravel 卡在 “Installing dependencies” 或 “Cloning Laravel repository”,大概率不是镜像问题,而是 GitHub API 限流导致——尤其没配 GITHUB_TOKEN 时。
解决方法有两个:
- 配置 GitHub token:composer config -g github-oauth.github.com your_actual_token_here
- 跳过 installer,改用 Git 克隆:git clone --depth=1 https://github.com/laravel/laravel.git myapp,再进目录运行 composer install
顺便检查 api.github.com 是否解析异常,可临时加 hosts:140.82.112.4 api.github.com
换源后还是慢?排查中间层干扰
阿里云镜像本身响应极快(通常
- 是否启用了 HTTPS 代理?关闭后再试
- 公司防火墙或校园网是否拦截或限速?尝试用手机热点测试
- 终端执行:curl -I https://mirrors.aliyun.com/composer/packages.json,看是否秒回 HTTP 200
不复杂但容易忽略











