直接运行composer config --global cache-dir命令即可确认当前缓存目录，linux/macos默认为~/.composer/cache，windows默认为%appdata%\composer\cache或%localappdata%\composer\cache，输出路径即composer实际使用的缓存根目录。

怎么确认 Composer 当前缓存目录在哪

别猜路径，直接让 Composer 自己说：composer config --global cache-dir。这个命令输出的就是它实际在用的缓存根目录，Linux/macOS 通常是 ~/.composer/cache，Windows 是 %APPDATA%\Composer\Cache（注意新版可能走 %LOCALAPPDATA%\Composer\Cache）。执行后立刻就能看到真实路径，避免误删其他目录。

缓存里哪些子目录占空间最多

进到缓存根目录后，你会看到三个核心子目录：files/、repo/、vcs/。其中真正吃磁盘的是：

• files/：所有下载过的 .zip 和 .tar 包归档，体积最大，90% 的缓存空间来自这里
• vcs/：Git 裸仓库缓存（如 github.com-xxx/），切分支或换源频繁时容易堆积废弃目录
• repo/：元数据快照（如 packages.json），体积小但关键，删了会导致首次 composer update 明显变慢

查占用大小最准的方式是：du -sh $(composer config --global cache-dir)（Linux/macOS）；Windows 用户直接打开资源管理器，粘贴路径后右键 → “属性”。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

怎么只看缓存里有哪些包文件（不全删）

想快速浏览已缓存的包名和版本，不用打开每个 ZIP，直接看 files/ 下的文件名：

• 文件名格式一般是 vendor-name-package-name-zip-hash.zip，比如 laravel-framework-10.42.0.zip
• 用 ls -lt ~/.composer/cache/files/ | head -20 查最近下载的 20 个包
• 用 find ~/.composer/cache/files -name "*.zip" -mtime +90 | wc -l 数出 90 天前的老包数量
• 注意：不要靠文件名判断是否“还在用”，同一个包不同版本可能共存，真正决定装哪个的是 composer.lock

手动删包文件前必须避开的坑

直接 rm -rf ~/.composer/cache/files 看似省事，但容易出问题：

• 必须先确保没有 composer 进程正在运行（包括 IDE 后台扫描、终端未退出的 install/update）
• 杀毒软件或 PHPStorm 可能锁住 ZIP 文件，删一半会报 Corrupted cache file
• 清完 files/ 后首次 composer install 会全部重下，如果网络差或包大（比如含前端资产的模板包），耗时明显增加
• 某些 CI 环境（如 GitHub Actions）挂了共享缓存卷，clear-cache 只清本地，对挂载卷无效

真正容易被忽略的是：私有源或镜像配置（比如 repositories 在全局 config 里）会让清完后的首次请求变慢——不是缓存没清干净，是元数据必须重新 fetch，这是设计使然。