Composer本身不生成临时文件,真正需清理的是三类关联产物:全局缓存~/.composer/cache/、项目级中间产物(如storage/cache/)、安装脚本残留composer-setup.php;vendor/及vendor/composer/下的文件属构建结果,不可手动删除。

Composer 本身不生成或管理“临时文件”,所谓“清理 Composer 临时文件”本质是清理它在运行过程中间接产生的缓存、下载残留和项目级中间产物——直接删 vendor/composer/ 或 ~/.composer/cache/ 可能导致下次 install 变慢甚至失败,必须分场景处理。
哪些目录算 Composer 相关的“临时文件”?
真正需要定期清理的,不是 Composer 自己的运行时临时文件(它几乎没有),而是三类关联产物:
-
~/.composer/cache/:全局下载包缓存,重复安装同一版本时复用,删了会重下,但不会破坏现有项目 -
vendor/composer/installed.json、vendor/composer/ClassLoader.php等:由composer install生成,属于构建结果,不是临时文件,不应手动删 -
composer.phar同级的composer-setup.php:这是安装脚本残留,属于真·临时文件,装完必须删
如何安全清理全局包缓存(~/.composer/cache/)?
这个目录体积增长最快,尤其频繁 create-project 或切换分支时。但它被多个项目共享,清空后所有项目首次 install 都会变慢。
- 查大小:
du -sh ~/.composer/cache/ - 只清过期包(推荐):
composer clear-cache—— 它会删掉已失效的 zip 包和 metadata,保留仍被composer.lock引用的版本 - 彻底清空(慎用):
rm -rf ~/.composer/cache/*,之后首次composer install会重新下载全部依赖 - 注意:Windows 下路径是
%APPDATA%\Composer\Cache,别用 Linux 命令硬套
为什么不能直接删 vendor/ 下的临时文件?
很多人看到 vendor/composer/ 里一堆 hash 命名的目录,以为是临时缓存。其实那是 autoload 优化生成的 class map 和 dump 文件,删了会导致:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
Class not found错误(autoload 失效) -
composer dump-autoload必须重跑,且耗时明显 - 某些框架(如 Laravel)的
bootstrap/cache/config.php也依赖它,删了可能启动报错
真正该清理的是项目自身的缓存(如 storage/cache/),而不是 vendor/ 里的内容。
部署时自动清理的可靠姿势
如果你在 CI/CD 或服务器上执行 git pull && composer install,建议在 composer.json 中加 post-install 钩子,但只清理项目级目录:
"scripts": {
"post-install-cmd": [
"if [ -d 'storage/cache' ]; then find storage/cache -type f -delete; fi",
"if [ -d 'bootstrap/cache' ]; then rm -rf bootstrap/cache/*; fi"
]
}
关键点:
- 所有
if [ -d '' ]判断必须保留,避免目录不存在时报错中断流程 - 不用
php artisan cache:clear,因为post-install-cmd执行时框架环境未就绪 - 别碰
vendor/任何子目录,那是 Composer 的工作区,不是你的垃圾场
最常被忽略的是:把 composer-setup.php 当成“已安装完就没事”的文件留在线上服务器,它具备可执行权限,一旦被利用就是远程代码执行入口——每次安装完必须立刻 unlink('composer-setup.php')。

















