直接运行 composer clear-cache 即可清除所有本地缓存，解决版本更新失败、checksum 不匹配、安装卡顿等问题；它会自动定位并删除缓存目录（如 ~/.composer/cache），显示清理的文件数与大小。
直接运行 composer clear-cache 就能清掉所有本地缓存，这是解决“明明包已更新却装不到最新版”“提示 checksum 不匹配”“安装时反复卡在某个包”这类奇怪问题最快速有效的第一步。
为什么需要清缓存？
Composer 会把下载过的包（zip/tar、dist 包、元数据）存在本地缓存目录里，下次安装相同版本时直接复用，加快速度。但缓存可能过期、损坏，或和远程仓库状态不一致——比如你刚发布了一个新 tag，但 Composer 还拿着旧的 packages.json 缓存，就会装错版本或报校验失败。
怎么清？一条命令搞定
在终端任意路径下执行：
composer clear-cache
它会自动找到并删除缓存目录（通常是：~/.composer/cache 或 %LOCALAPPDATA%\Composer\cache），然后显示清理了多少 MB 和文件数。
清完还不好使？试试这几个动作
- 删掉项目根目录下的 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）或用资源管理器打开路径查看大小
基本上就这些。缓存不是总出问题，但一旦出问题，表现得很“玄学”。养成安装异常时先清缓存的习惯，省去很多排查时间。
