composer install 慢因默认直连国外 packagist.org,应全局配置阿里或腾讯镜像源:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/,验证用 composer config -g repo.packagist。

composer install 为什么慢到想重装系统?
因为默认走 packagist.org,国内直连经常超时或限速,composer install 卡在 Downloading https://packagist.org/packages.json 是最典型症状。不是你网络差,是源本身没走国内 CDN。
怎么切到阿里/腾讯镜像源?
别手动改 composer.json 里的 repositories——那是项目级临时方案,治标不治本。全局生效的正确姿势是改 Composer 自己的配置:
- 运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/(阿里源) - 或换腾讯源:
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 验证是否生效:
composer config -g repo.packagist应该输出对应 URL
注意:-g 表示全局,影响所有项目;如果某项目必须用官方源,进项目目录执行 composer config repo.packagist composer https://packagist.org 覆盖即可。
镜像源失效了怎么办?
阿里云和腾讯云镜像基本稳定,但偶尔会同步延迟(比如新发布的包几小时内搜不到),错误现象是 Could not find package xxx at any version,但官方源能查到。
- 先确认包名拼写和版本约束是否正确,排除误判
- 临时切回官方源测试:
composer config -g repo.packagist composer https://packagist.org - 同步延迟一般不超过 2 小时,不用急着换源;长期失效才考虑切华为云或中科大源
镜像本质是定时同步,不是实时代理,这点容易被忽略。
laravel/installer 或 create-project 依然很慢?
因为这类命令会先拉 composer create-project 的骨架,再跑 install,而骨架元数据仍可能从官方源读取。解决方法是提前预置镜像配置:
- 运行
composer global require laravel/installer前,确保已配置好全局镜像 - 用
create-project时加--repository-url参数:composer create-project laravel/laravel demo --repository-url=https://mirrors.aliyun.com/composer/ - 部分老版本 Composer(--repository-url 支持不全,建议升级到
composer self-update
镜像只加速包下载,不加速 autoload 生成或脚本执行——如果 install 后半段还卡,问题不在源。










