直接运行composer clear-cache只能清理部分缓存,真要“彻底”需手动删vcs/、repo/https---packagist.org/、vendor/composer/installed.json和composer.lock,并配合--no-cache --force-checksums重装。

直接运行 composer clear-cache 只能清理部分缓存,真要“彻底”,必须手动删目录 + 清理元数据 + 验证锁文件状态——否则空间没释放、版本仍滞后、下次 install 还报错。
为什么 composer clear-cache 经常不顶用
它默认跳过 vcs/ 目录(单个 Git 裸仓库占 300–800 MB),也不清 repo/https---packagist.org/ 下的 provider 索引,更不管 vendor/composer/installed.json 和 composer.lock 的本地约束。常见现象包括:
- 执行后
du -sh显示缓存大小几乎不变 -
composer update仍拉不到新版本,日志里还出现packages.json的旧哈希 - 报
Corrupted zip file,但clear-cache后重装还是失败
确认真实缓存路径和占用再动手
别信默认路径。公司镜像、COMPOSER_CACHE_DIR 环境变量、或 snap 安装都可能让缓存藏在别处:
- 查真实路径:
composer config --global cache-dir - Linux/macOS 查大小:
du -sh $(composer config --global cache-dir) - Windows 查大小:把输出路径粘进资源管理器地址栏 → 右键“属性”
- 超 1.5 GB 且半年没碰老项目,才值得清;不到 200 MB 基本不用管
手动清理三处关键位置
只靠 clear-cache 不够,这三块必须一起动:
-
rm -rf ~/.composer/cache/vcs/*(Linux/macOS)或rd /s /q "%APPDATA%\Composer\Cache\vcs"(Windows)——解决 Git 克隆缓存膨胀和 inode 耗尽 -
rm -rf ~/.composer/cache/repo/https---packagist.org/——强制下次update重拉最新packages.json,解决版本滞后 -
rm -f vendor/composer/installed.json composer.lock——绕过本地版本锁定,避免校验失败卡住
清完必须加 --no-cache --force-checksums 重装
缓存空了,但 Composer 默认仍会尝试复用旧 checksum 或跳过下载。不加参数,很可能又载入损坏 ZIP 或旧索引:
- 先备份:
cp composer.lock composer.lock.bak - 删干净:
rm -rf vendor composer.lock - 重装并强制校验:
composer install --no-cache --force-checksums - 验证是否真走网络:
composer install -v --no-cache 2>&1 | grep "Downloading\|Extracting"
真正容易被忽略的是 composer.lock 和 installed.json 的耦合关系——它们不是缓存,但行为完全依赖缓存内容;删一半留一半,比不删还容易出错。


















