Composer 临时文件主要位于 vendor/.composer/ 下以 tmp- 开头的目录及 vendor/ 中孤立 .tmp- 文件;clear-cache 仅清理 COMPOSER_HOME/cache/ 中的归档,不处理这些执行残留。

Composer 的临时文件存在哪里
Composer 默认把下载的包缓存和解压中间产物放在 COMPOSER_HOME 目录下的 cache/ 和 vendor-bin/(如果用了插件)里,但真正容易堆积“临时文件”的其实是 composer install 或 update 过程中生成的未完成解压目录、.zip 临时副本、以及失败后残留的 vendor/.composer/tmp-xxxxx 文件夹。
为什么 composer clear-cache 不够用
composer clear-cache 只清 cache/ 下已下载的归档(.zip/.tar.gz),它不碰 vendor/ 下的临时解压目录、失败残留的 .tmp- 前缀文件夹,也不清理 composer.lock 生成过程中可能写到一半的临时文件。
- 常见现象:反复
composer update失败后,vendor/.composer/下出现多个tmp-*目录,占用空间且干扰后续操作 - 这些目录权限可能异常(比如 root 写入,当前用户无法删除),导致下一次 install 卡在“cannot remove tmp dir”
-
clear-cache对它们完全无效
手动清理临时文件的可靠方式
最直接的办法是定位并删除 vendor/.composer/ 下所有 tmp- 开头的目录,同时检查 vendor/ 根目录下是否有孤立的 .tmp- 文件或损坏的空文件夹。
- 执行:
rm -rf vendor/.composer/tmp-*
- 顺手检查:
ls -la vendor/ | grep '\.tmp\|^\.$'
,对疑似残留手动rm -rf - 如果项目用了
composer-plugin-api类插件(如hirak/prestissimo),还要看插件是否在COMPOSER_HOME下建了额外缓存目录,比如~/.composer/vendor/hirak/prestissimo/cache/ - Windows 用户注意:
rm -rf换成rd /s /q vendor\.composer\tmp-*,且 PowerShell 中通配符需加引号
能否让 Composer 自动清理?目前没有内置开关
Composer 官方没提供类似 --auto-clean-tmp 的参数,也没有钩子能绑定到“任务结束前自动删 tmp”。所谓“自动”,只能靠外部手段补位:
- 在 CI/CD 脚本里,每次
composer install前加一句rm -rf vendor/.composer/tmp-* - 用
make或 shell 别名封装常用命令,比如 aliasci="rm -rf vendor/.composer/tmp-* && composer install" - 警惕某些第三方插件声称“自动清理”——多数只是包装了
clear-cache,对真正的 tmp 目录无效
临时文件本身是 Composer 执行模型的一部分,清理时机依赖于进程退出状态,强行在代码层插入清理逻辑反而容易引发竞态。所以别等“自动”,定位清楚 tmp- 目录位置,把它纳入你的部署或本地开发清理 checklist 就行。


















