如何解决 Composer 在执行 update 时卡住不动的问题？

Composer update卡住通常因网络慢、镜像源差或依赖解析耗时长；可换国内镜像源、清缓存、跳过平台检查、限制更新范围或升级Composer解决。

Composer update 卡住，多数情况不是真“卡死”，而是网络慢、包源慢或依赖解析耗时长。先别急着 Ctrl+C，试试下面几个方向。

检查是否在下载包时卡住

Composer 默认走 packagist.org，国内访问常不稳定。终端里看到类似 Downloading https://packagist.org/p/monolog/monolog/... 这样的日志，基本就是网络问题。

• 换国内镜像源：运行 composer config -g repo.packagist composer https://packagist.phpcomposer.com（已停用）或更推荐的：composer config -g repo.packagist composer https://packagist.laravel-china.org
• 或者用阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 执行完再试 composer update -v（加 -v 看详细日志，确认卡在哪一步）

跳过平台配置检查（尤其 Windows + WSL 或 Docker 环境）

有时 Composer 会反复检查 PHP 扩展或版本兼容性，在某些环境（比如没装 ext-zip 的容器里）可能假死或超时。

• 加参数跳过检查：composer update --ignore-platform-reqs
• 如果只缺个别扩展，可指定跳过：composer update --ignore-platform-req=ext-zip
• 注意：仅临时调试用，上线前仍需补全依赖环境

清理缓存 & 限制更新范围

缓存损坏或试图更新整个依赖树，都可能导致长时间无响应。

标签： composer 卡住不动 php laravel docker windows 阿里云 win 镜像源 网络问题