解决 composer 下载速度慢或超时的终极办法

更换国内镜像源可解决Composer下载慢问题，推荐使用阿里云、中科大或华为云镜像，通过composer config命令设置全局或项目级源，并调整超时时间、启用并行下载以提升稳定性，必要时清除缓存验证效果。

Composer 下载慢或超时，主要原因是默认的官方源位于境外，网络不稳定。要彻底解决这个问题，核心思路是更换为国内镜像源 + 优化本地配置。以下是具体可行的方法。

使用国内镜像源

国内多个机构提供了 Packagist 的完整镜像，切换后能显著提升下载速度。

• 阿里云镜像（稳定推荐）：
  执行命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 中国科学技术大学镜像：
  命令：composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/
• 华为云镜像：
  命令：composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/

设置后，所有项目都会默认使用该镜像，无需逐个修改。

临时使用镜像而不更改全局配置

如果只想在当前项目中使用镜像，去掉 -g 参数即可：

灵办AI

免费一键快速抠图，支持下载高清图片

78

查看详情

• 进入项目目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
• 这样只影响当前项目的 composer.json

调整 Composer 超时和稳定性设置

即使换了镜像，偶尔仍可能因网络波动失败。适当调高超时时间可减少中断。

• 增加 HTTP 超时时间：composer config -g process-timeout 3600
• 启用并行下载（提升效率）：composer config -g preferred-install dist
• 关闭 SSL 验证（仅限特殊网络环境，不推荐长期使用）：
  composer config -g secure-http false，注意风险

清除缓存并验证效果

配置完成后，清理旧缓存避免干扰：

• 运行：composer clear-cache
• 然后执行 composer install 或 composer update 测试速度
• 观察是否仍有超时或卡顿

基本上就这些。换源是关键，配合合理配置，99% 的下载问题都能解决。如果依然缓慢，检查本地网络或尝试切换不同镜像源。不复杂但容易忽略细节。

以上就是解决 composer 下载速度慢或超时的终极办法的详细内容，更多请关注php中文网其它相关文章！