执行 composer clear-cache 是最安全的清缓存方式，它会暂停写入锁、逐个清空子目录、重置索引并保留配置；手动删 ~/.composer/cache 易致报错、权限异常、校验失败及 VCS 镜像损坏。
直接执行 composer clear-cache 就能清空所有本地下载缓存，释放磁盘空间。这是最安全、最推荐的方式，无需手动删文件。
为什么不能直接删 ~/.composer/cache 目录？
手动删除缓存目录看似简单，但容易出问题：
-
composer进程可能正在写入缓存，强制删会导致后续命令报错（如Failed to decode response: zlib_decode(): data error） - 某些平台（如 Windows + WSL）下路径权限或符号链接可能异常，删完后
composer无法重建结构 - 缓存目录里还包含
repo和files子目录，它们的校验逻辑耦合紧密，缺一不可 - Composer 8+ 默认启用
cache-vcs，手动删会破坏 Git 仓库镜像状态，导致下次install拉取变慢
composer clear-cache 实际做了什么？
这个命令不是简单清空目录，而是按 Composer 内部缓存协议安全清理：
- 先暂停所有活跃的缓存写入锁（
.lock文件） - 逐个清空
repo（包元数据）、files（归档包）、downloads（临时下载）子目录 - 重置缓存索引（
cache.json），避免下次运行时读到脏状态 - 不碰
config.json或auth.json，凭证和配置完全保留
执行后你会看到类似输出：Cleared cache for all packages (X MiB)，括号里的数值就是真实释放的空间大小。
清理后首次安装变慢是正常的
缓存清空后，第一次 composer install 或 composer update 会重新下载包并重建缓存，耗时明显增加：
- 如果用的是 Packagist 官方源，延迟通常在 2–5 分钟（取决于网络和依赖数量）
- 国内用户建议搭配阿里云镜像源（
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/），可大幅缩短恢复时间 - 若项目启用了
composer.lock，且依赖未变更，install阶段仍会复用已下载的 zip 包（只要没被其他命令触发清理）
真正要警惕的是“定期自动清缓存”——除非磁盘空间持续告急，否则没必要频繁运行 clear-cache。Composer 的 LRU 缓存淘汰机制本身就会限制总大小（默认 300 MiB），多数情况下它自己管得比人勤快。
