composer clear-cache仅清除~/.composer/cache/（Linux/macOS）或%APPDATA%\Composer\Cache（Windows）下的包归档、解压文件及元数据，不触碰项目文件、vendor目录或composer.lock；清缓存前应先用composer config --global cache-dir确认路径并检查大小，避免误操作。
直接运行 composer clear-cache 就能清掉本地缓存文件，但它只删 ~/.composer/cache/（Linux/macOS）或 %APPDATA%\Composer\Cache（Windows）下的内容，不会动你的项目文件。
怎么确认缓存真占地方？别瞎清
很多人一看到磁盘告警就跑 composer clear-cache，结果发现空间没少多少——因为缓存可能根本不是元凶。
- 先查路径：
composer config --global cache-dir，看它实际指向哪 - 再看大小：Linux/macOS 用
du -sh $(composer config --global cache-dir)；Windows 直接打开资源管理器，导航到%APPDATA%\Composer\Cache看“属性” - 不到 200MB 基本不用管；超过 1.5GB 且你半年没碰某些老项目，才值得动手
- 有些公司把缓存挂到 NFS 或自建镜像目录，
clear-cache默认只清配置里那个路径，不会遍历所有可能位置
为什么清完还是装旧包、还是报错？
缓存只是加速层，不是决策源头。清了它，不代表依赖会升级、也不代表网络问题能解决。
-
composer install装什么，由composer.lock和repositories配置决定；清缓存只是让它重新下载远程元数据，不一定触发版本变化 - 遇到
file could not be downloaded或Failed to decode JSON，大概率是网络、源配置或代理问题，不是缓存脏了 - 刚切了国内镜像（比如阿里云），但还报 404？先确认
composer config repo.packagist false已生效，否则缓存清理白搭 - 私有源响应头带
X-Composer-Cache-TTL（如腾讯云 TKE 镜像），本地清了也没用，得等镜像源自己过期，或临时切回官方源验证
想精准删部分缓存？官方不支持，只能手动
composer clear-cache 是全量清，没有按包名、按时间、按大小筛选的选项。所谓“精准”，只能靠你自己进目录判断。
-
~/.composer/cache/files/：存所有.zip/.tar包，冗余最多。可用find ~/.composer/cache/files -name "*.zip" -mtime +90 -delete清 90 天前的 -
~/.composer/cache/vcs/：存 Git 浅克隆，切分支/换源频繁时容易积攒废弃目录。rm -rf ~/.composer/cache/vcs/*安全，下次需要时自动重建 -
~/.composer/cache/repo/：核心索引缓存，删了会导致首次composer update明显变慢，不建议动 - 手删前务必确认
composer进程已退出，否则可能删到一半被写入，后续报Corrupted cache file
真正卡住的往往不是缓存本身，而是源配置、PHP 扩展缺失（比如没开 openssl）、公司代理策略，或者你刚手动改过 ~/.composer/cache/ 里的文件——这时候清才有意义。其他时候，clear-cache 很可能只是个安慰剂操作。
