如何清除Composer的缓存？（解决奇怪的安装问题）

直接运行 composer clear-cache 即可清除所有本地缓存，解决版本更新失败、checksum 不匹配、安装卡顿等问题；它会自动定位并删除缓存目录（如 ~/.composer/cache），显示清理的文件数与大小。

直接运行 composer clear-cache 就能清掉所有本地缓存，这是解决“明明包已更新却装不到最新版”“提示 checksum 不匹配”“安装时反复卡在某个包”这类奇怪问题最快速有效的第一步。

为什么需要清缓存？

Composer 会把下载过的包（zip/tar、dist 包、元数据）存在本地缓存目录里，下次安装相同版本时直接复用，加快速度。但缓存可能过期、损坏，或和远程仓库状态不一致——比如你刚发布了一个新 tag，但 Composer 还拿着旧的 packages.json 缓存，就会装错版本或报校验失败。

怎么清？一条命令搞定

在终端任意路径下执行：

composer clear-cache

它会自动找到并删除缓存目录（通常是：~/.composer/cache 或 %LOCALappDATA%Composercache），然后显示清理了多少 MB 和文件数。

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

185

查看详情

清完还不好使？试试这几个动作

• 删掉项目根目录下的 vendor 文件夹和 composer.lock，再运行 composer install —— 彻底重装，避免 lock 文件残留旧约束
• 加 –no-cache 参数临时跳过缓存：composer update –no-cache，确认是否真由缓存引起
• 检查是否用了镜像源（如阿里云、腾讯云），镜像同步有延迟；可临时切回官方源测试：composer config -g repo.packagist composer https://packagist.org

顺便看看缓存位置和大小

想确认缓存是否存在或占多少空间，可以运行：

composer config -g cache-dir —— 查看路径
composer show –platform | grep -i cache（linux/macOS）或用资源管理器打开路径查看大小

基本上就这些。缓存不是总出问题，但一旦出问题，表现得很“玄学”。养成安装异常时先清缓存的习惯，省去很多排查时间。