更换国内镜像源可解决Composer下载卡顿问题，推荐使用阿里云或Laravel China镜像，配合调整超时时间、清除缓存及优化网络环境，确保下载流畅。
遇到 Composer 下载速度为 0 B/s 或卡住不动，通常是因为默认的官方源（packagist.org）在国内访问不稳定或被限速。解决这个问题的核心是更换镜像源并优化网络环境。以下是几种有效的方法：
使用国内镜像源加速下载
将 Composer 的默认源替换为国内镜像，可以大幅提升下载速度。
-
阿里云镜像：执行命令切换全局镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
中国全量镜像（Laravel China）：
composer config -g repo.packagist composer https://packagist.phpcomposer.com - 切换后可通过查看配置确认是否生效：
composer config -l | grep repo.packagist
检查并设置正确的 Composer 配置
某些配置可能导致连接超时或无法下载。
- 确保禁用 HTTPS 验证问题（不推荐长期使用）：
composer config -g disable-tls true
建议优先修复 CA 证书问题而非关闭 TLS。 - 增加超时时间，避免因网络慢导致中断：
composer config -g process-timeout 3600composer config -g http.timeout 300 - 清除缓存以防旧数据干扰：
composer clear-cache
优化网络环境
Composer 卡住也可能是本地网络问题。
- 尝试开启系统代理或科学上网工具，确保能正常访问境外服务器。
- 修改 hosts 文件，绑定 packagist.org 到较快 IP（效果有限且不稳定，建议配合镜像使用）。
- 避免在高峰时段进行大包安装，减少网络拥堵影响。
手动下载并放入缓存目录（应急方案）
当某个包始终无法下载时，可手动处理。
- 找到 Composer 缓存路径：
composer config cache-dir - 进入对应的版本缓存目录（如
files/vendor/package/），手动放入下载好的 zip 包。 - 再次运行
composer install，Composer 会校验哈希并跳过下载。
基本上就这些。最有效的办法是使用国内镜像源，再配合合理的超时和缓存设置。只要网络通路畅通，99% 的卡顿问题都能解决。
