composer clear-cache 只清除 ~/.composer/cache 或 %APPDATA%\Composer\Cache 下的 files/、repo/、vcs/ 缓存,不触碰 vendor/、composer.lock、composer.json 等项目文件。

composer clear-cache 能清什么、不能清什么
它只清 ~/.composer/cache(Linux/macOS)或 %APPDATA%\Composer\Cache(Windows)下的内容,包括:files/(所有 .zip/.tar 包)、repo/(packages.json 快照等元数据)、vcs/(git 克隆缓存)。不会动你的 vendor/、composer.lock、composer.json,也不会删系统配置或项目文件。
常见误判:运行 composer install 还是装旧版 → 那不是缓存没清干净,而是 composer.lock 锁死了版本,或镜像源的元数据还没更新(TTL 通常 24 小时)。
- 清完后首次
composer install变慢?正常。所有包要重下、重解压,尤其含大前端资产的包(如laravel/ui) - CI/CD 中无脑加
composer clear-cache?反而拖慢构建。缓存本该复用,不是每次都要重来 - 你改了私有包 tag 却一直装旧版?这时候清缓存才真有用——否则 Composer 会直接复用本地解压结果,根本不查远程
先看缓存占多少空间,再决定要不要清
别一上来就 composer clear-cache。先确认它是不是真占地方、路径对不对、有没有被公司镜像改过位置。
- 查当前路径:
composer config --global cache-dir - 看大小(Linux/macOS):
du -sh $(composer config --global cache-dir) - Windows 用户:打开资源管理器,导航到
%APPDATA%\Composer\Cache,右键“属性” - 有些团队把缓存挂到 NFS 或自建镜像目录,
clear-cache默认只清全局配置指向的那个路径,不会遍历所有可能位置
如果不到 200MB,大概率不是磁盘告警主因;超过 1.5GB,且你半年没碰过某些老项目,那就可以动手了。
想精准清理?没有内置命令,只能手动筛
composer clear-cache 是全量清,但 Composer 不提供按包名、按时间、按大小筛选的选项。“精准清理”只能靠你自己进目录认路。
- 清理老 zip 包(90 天前):
find ~/.composer/cache/files -name "*.zip" -mtime +90 -delete - 清废弃 git 缓存:
rm -rf ~/.composer/cache/vcs/*(安全,下次需要自动重建) - 别乱动
repo/packagist.org/:这是核心索引,删了会导致首次composer update明显变慢 - 手删前确保
composer没在后台运行,否则可能引发Corrupted cache file报错
清完还出问题?别只盯着缓存
缓存只是其中一环。很多所谓“清了没用”的情况,根源根本不在缓存里。
- 报
Could not find package xxx?先检查composer.json里repositories配置是否指向已下线的私有源 - 装的版本和
packagist.org页面显示不一致?试试临时切回官方源:composer config -g repo.packagist composer https://packagist.org - 提示
vendor/autoload.php not found?这不是缓存问题,是vendor/根本没生成。得先composer install或composer update,再跑dump-autoload - 频繁遇到
Failed to extract xxx?优先怀疑磁盘写入中断导致 zip 损坏,这时cache-clear才是正解
真正省事的方式其实是定期 composer self-update——新版对缓存压缩和复用更聪明,比反复清更能稳住磁盘增长节奏。











