composer clear-cache 无法删除未完成安装的临时文件,因为它只清理 ~/.composer/cache 或 %appdata%\composer\cache 下的持久缓存,而临时 zip、phar 及解压碎片均生成于 sys_get_temp_dir() 返回的系统临时目录(如 /tmp、%temp%),该命令完全不触及该位置。

composer clear-cache 为什么删不掉未完成安装的临时文件
因为 composer clear-cache 只清理 ~/.composer/cache/(Linux/macOS)或 %APPDATA%\Composer\Cache(Windows)下的持久缓存,而未完成安装时产生的临时 ZIP、PHAR、解压碎片等,全落在系统临时目录里——sys_get_temp_dir() 返回的位置,比如 /tmp(Linux)、/var/folders/...(macOS)、C:\Users\XXX\AppData\Local\Temp(Windows),clear-cache 完全不碰这里。
怎么定位和清理这些残留的临时文件
先确认系统临时目录在哪:
- Linux/macOS:运行
php -r "echo sys_get_temp_dir();" - Windows(CMD):运行
php -r "echo sys_get_temp_dir();",注意 PowerShell 中需用双引号包裹整个字符串
常见残留文件名特征:
-
composer_*.zip或composer_*.tar(下载中断的包归档) -
php*.phar(如php56234.phar,Composer 下载器生成的临时 PHAR) -
extract_*/或temp_*/开头的空目录(解压中途失败留下的)
安全清理命令示例:
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS:
find "$(php -r 'echo sys_get_temp_dir();')" -name 'composer_*' -o -name 'php*.phar' -delete 2>/dev/null - Windows(CMD):
forfiles /p "%TEMP%" /m "composer_*" /c "cmd /c del @path" & forfiles /p "%TEMP%" /m "php*.phar" /c "cmd /c del @path"
CI/CD 或 Docker 构建中特别容易堆积的原因
在无交互、短生命周期环境里,Composer 下载失败后不会自动清理临时文件,尤其遇到网络抖动或镜像源超时。更麻烦的是:clear-cache --no-interaction 看似跑完了,但临时目录早已塞满几百 MB 的 composer_*.zip。
- GitHub Actions/GitLab CI 中建议在
before_script或构建末尾加一步清理:rm -f $(php -r "echo sys_get_temp_dir();")/composer_*.zip $(php -r "echo sys_get_temp_dir();")/php*.phar - Docker 构建时,如果用了多阶段构建,确保
composer install阶段结束后执行清理,否则临时文件会打包进最终镜像 - 某些杀毒软件或 Windows Defender 实时扫描会锁住
php*.phar,导致删除失败,可临时禁用实时保护再试
如何避免下次再产生这类隐藏残留
根本上不是“清得够不够快”,而是让 Composer 少造临时垃圾:
- 强制走 dist 包而非 source:
composer install --prefer-dist --no-interaction,跳过 Git 克隆和本地解压逻辑,大幅减少临时文件生成 - 禁用 VCS 缓存(如果不用 Git 源):
composer config --global cache-vcs false,避免vcs/目录和配套临时操作 - 设置缓存上限防膨胀:
composer config --global cache-max-size "500M"(Composer 2.5+ 支持) - 不要在
/tmp所在分区极小的机器上跑composer update,它可能把临时解压占满整个/tmp导致后续命令失败
真正难处理的从来不是缓存目录本身,而是那些没名字、没日志、没路径提示的临时文件——它们不报错,只悄悄吃光磁盘 inode 或空间,直到某次 composer install 突然卡死在 “Extracting archive” 那一行。










