composer clear-cache 不识别“废弃包”,仅批量删除 cache/files/、repo/、vcs/ 目录内容;所谓废弃缓存是人为业务判断,需手动比对所有 composer.lock 中的依赖版本后谨慎清理 files/ 中未被引用的 .zip 文件。

composer clear-cache 不能识别“废弃包”,它只清目录,不判断语义
Composer 没有内置机制标记或识别“已被废弃(abandoned)”的包——clear-cache 命令根本不管 packagist.org 上是否显示 abandoned: "monolog/monolog",它只按路径批量删除 cache/files/、cache/repo/、cache/vcs/ 下所有内容。所谓“废弃包缓存”是人对业务的理解,不是 Composer 的缓存分类。
你真正想清理的,其实是:那些当前所有项目 composer.lock 文件里完全没引用、且在 Packagist 上已标为 abandoned 的包归档(.zip)和元数据。
- 先确认哪些包被标记为废弃:
composer show --all | grep -i abandoned(仅列出声明,不反映本地缓存状态) - 再查本地是否真存着这些包的旧版 zip:
ls ~/.composer/cache/files/ | grep -i "monolog-monolog" - 关键点:即使一个包被 abandon,只要你的某个
composer.lock还锁着它的某个版本,这个 zip 就不算“废弃缓存”,删了下次 install 还得重下
手动清理前必须确认:该包版本确实未被任何 lock 文件引用
别凭印象删。一个包可能在 A 项目里废弃了,但在 B 项目的 composer.lock 中仍是活跃依赖。直接删 zip 会导致 B 项目下次 composer install 失败(报 Could not fetch ... corrupt cache 或 404)。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 汇总所有项目中用到的包版本:遍历每个项目的
composer.lock,提取"name"和"version"字段(可用jq -r '.packages[] | "\(.name) \(.version)"') - 进
~/.composer/cache/files/,按目录名(如monolog-monolog)分组,检查子文件是否全在上述列表中 - 只删那些文件名匹配但版本号完全未出现在任何 lock 文件里的
*.zip(例如monolog-monolog-1.17.2.zip,而所有 lock 里只写2.4.0) - Windows 用户注意路径分隔符:
dir "%APPDATA%\Composer\Cache\files" /s /b | findstr "monolog"
vcs/ 目录可以整删,但 files/ 里删错版本会拖慢后续 install
cache/vcs/ 存的是 Git 裸仓库,删了只是下次拉 VCS 包时多花几秒克隆,安全;但 cache/files/ 里删掉一个正在用的 zip,就会强制重新下载——尤其当镜像源不稳定或包体积大(如 laravel/framework 含大量 assets)时,延迟明显。
- 安全操作:
rm -rf ~/.composer/cache/vcs/*(Linux/macOS)或rd /s /q "%APPDATA%\Composer\Cache\vcs"(Windows) - 风险操作:删
cache/files/monolog-monolog-2.4.0.zip→ 若某项目 lock 锁的是2.4.0,下次 install 就卡在下载 - 真正省事的做法:定期运行
composer self-update,新版 Composer 对 dist 包复用更智能,比手动筛 zip 更能抑制缓存膨胀
CI/CD 或多用户环境里,别信默认路径,先看 cache-dir 实际指向哪
在 GitHub Actions、Docker 构建或公司内网镜像环境下,COMPOSER_CACHE_DIR 可能被设为 /tmp/composer-cache 或 NFS 挂载点。composer clear-cache 默认只清 config --global cache-dir 返回的位置,如果该路径被覆盖但你没意识到,就等于白跑。
- 务必执行:
composer config --global cache-dir,而不是假设是~/.composer/cache - 验证是否真在本地磁盘:
df -h $(composer config --global cache-dir | tr -d '\n')(Linux/macOS),避免清到远程存储上还误以为空间释放了 - 权限问题常见于 Docker:root 写的缓存,非 root 用户执行
clear-cache会静默失败(无报错但文件还在),加ls -l $(composer config --global cache-dir)看 owner
prune-abandoned 这类命令,因为“废弃”是业务语义,不是缓存生命周期的一部分。最易被忽略的,是跨项目 lock 文件的版本交叉引用——删之前,永远先 grep -r "package-name" */composer.lock。










