最直接有效的办法是将Composer默认源切换为国内镜像,执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可全局生效,所有项目自动使用阿里云镜像源,并建议运行composer clear-cache清理缓存。

Packagist 连不上,本质是境外源访问不稳定或被限制造成的,不是 Laravel 本身的问题。最直接有效的办法就是把 Composer 默认源切换成国内镜像,全局设置一次,所有项目都受益。
推荐用阿里云或 Laravel China 镜像
这两个镜像同步及时、响应稳定,目前可用性高:
- 阿里云镜像地址:https://mirrors.aliyun.com/composer/
- Laravel China 镜像地址:https://packagist.laravel-china.org
腾讯云、华为云镜像也可选,但阿里云和 Laravel China 社区维护更活跃,出问题时更新更快。
执行全局镜像切换命令
打开终端,运行以下任一命令(推荐阿里云):
- 设为阿里云镜像:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 设为 Laravel China 镜像:composer config -g repo.packagist composer https://packagist.laravel-china.org
执行后无需重启终端,后续所有 composer install、create-project 等操作都会自动走国内源。
验证是否生效 & 清理缓存
运行下面命令查看当前配置:
- composer config -g repo.packagist —— 应返回你刚设置的镜像 URL
- composer clear-cache —— 建议顺手清一下缓存,避免旧包干扰
如果之前卡在下载中途,清理后重试基本能立刻恢复。
临时或项目级切换(备用方案)
不想改全局?也可以按需使用:
- 单次命令指定镜像:composer install --repository=https://mirrors.aliyun.com/composer/
-
仅当前项目生效:进项目目录,去掉
-g参数运行:composer config repo.packagist composer https://mirrors.aliyun.com/composer/
项目级设置会写入 composer.json 的 repositories 字段,不影响其他项目。


















