composer clear-cache 不清 vendor/、临时解压目录及系统临时文件,真正占空间的是这些位置;需用 df -i 检查 inodes 是否耗尽,并确认缓存路径是否指向小容量分区。

composer clear-cache 为什么清完还是报磁盘满
因为 composer clear-cache 只动 ~/.composer/cache/(Linux/macOS)或 %APPDATA%\Composer\Cache(Windows)里的 repo/、files/、vcs/,不碰 vendor/、临时解压目录、系统 /tmp 或 %TEMP%。真正吃空间的往往是:
- 项目里反复
composer install留下的旧vendor/(尤其 Laravel/Symfony 大包带.git) - Composer 在
sys_get_temp_dir()解 zip 时爆掉的临时文件(Windows 常在C:\Users\xxx\AppData\Local\Temp) -
cache/vcs/下的裸 Git 仓库(单个可能几百 MB,但clear-cache默认会清) - 镜像源配置错误导致重复拉取元数据,缓存路径指向了小容量分区(比如
C:盘)
怎么确认缓存真占多少空间、是不是在错的地方
别凭感觉删。先查路径,再看体积:
- 运行
composer config --global cache-dir,输出就是 Composer 当前认的缓存根目录 - Linux/macOS:接上
du -sh $(composer config --global cache-dir),直接看到大小 - Windows:把
%APPDATA%\Composer\Cache粘贴进资源管理器地址栏,右键 → “属性” - 如果结果不到 200MB,基本不是元数据缓存的问题;超 1.5GB 且你半年没碰对应项目,才值得动手
- 额外检查:
echo $(sys_get_temp_dir())(PHP 命令)或echo $TMPDIR(macOS/Linux)、echo %TEMP%(Windows),这些地方也常被 Composer 高频写入
只清 repo/ 元数据而不动 files/zip 包
有时你只是想让 composer update 能拉到新版包(比如 packagist.org 已更新但本地 repo 缓存太旧卡住),又不想重下所有 zip —— 这时全量 clear-cache 是杀鸡用牛刀。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 手动删元数据最安全:
rm -rf ~/.composer/cache/repo/(Linux/macOS)或进%APPDATA%\Composer\Cache\repo\全选删除(Windows) - 删完首次
composer update会慢一点(要重新 fetch packages.json),但不会重下.zip - 注意:
cache/repo/packagist.org/删了无妨,下次自动重建;但别去动cache/vcs/里的东西,除非你明确知道哪些 Git 仓库不再需要 - 如果公司用了私有镜像,确保
composer config --global repos.packagist.org.url指向的是正确地址,否则清了也白清
清完仍提示 No space left on device?可能是 inodes 耗尽
特别是 WSL、macOS APFS 或某些云主机上,df -h 显示还有 20GB,却报 “disk quota exceeded” 或 “No space left on device”——这八成是 inodes(文件节点)满了,不是磁盘块不够。
- Linux/macOS 检查:
df -i,看IUse%是否接近 100% - inodes 满的典型原因:缓存目录里存在海量小文件(比如
cache/files/下成千上万个.zip,或cache/vcs/下一堆浅克隆) - 解决方法:删掉整个
cache/files/和cache/vcs/(cache/repo/可留着,它文件少);或者换缓存位置到大分区:composer config --global cache-dir "/mnt/big-disk/composer-cache" - Windows 用户注意:
%TEMP%下的 Composer 临时解压文件也极容易撑爆 inodes,建议定期清空该目录
真正麻烦的从来不是缓存本身,而是缓存路径和临时目录混在系统盘、又长期没人管。清一次缓存顶多省几 GB,但把 cache-dir 和 sys_get_temp_dir() 指向大分区,能一劳永逸。

















