如何清理 Composer vendor 目录中不必要的文件（如文档、测试）来减小项目体积？_技术学堂

如何清理 Composer vendor 目录中不必要的文件（如文档、测试）来减小项目体积？

发布时间：2025-12-13 11:07

发布者：网络

浏览次数：

可配置 Composer 的 archive 选项或使用 composer-cleaner 插件自动剔除非运行必需文件以减小 vendor 体积；archive 配置仅对 dist 包生效，插件支持自定义清理规则并自动触发，配合部署脚本可进一步精简，最终缩减 30%~60% 体积。

如何清理 composer vendor 目录中不必要的文件（如文档、测试）来减小项目体积？

可以配置 Composer 的 archive 选项或使用插件，在安装/更新时自动剔除文档、测试、Git 目录等非运行必需文件，从而显著减小 vendor 体积。

在项目根目录的 composer.json 中添加 archive 配置，控制从包中排除哪些路径：

支持通配符，如 "exclude": ["/tests", "/Tests", "/docs", "/Docs", "/.*", "/phpunit.xml", "/CHANGELOG.*"]
该配置仅对从 Packagist 下载的 zip 包生效（即 "dist" 源），对 "source"（git clone）无效
修改后需重新执行 composer install 或 composer update 才会生效

这是一个轻量、专注清理的第三方插件，能自动删除常见冗余内容：

安装：composer require --dev dealerdirect/composer-cleaner
它默认清理：.git、.github、tests、Tests、docs、Examples、phpunit.xml、CHANGELOG、CONTRIBUTING.md 等
支持自定义规则，在 composer.json 中加 "cleaner-exclude" 字段即可扩展
清理动作在 post-autoload-dump 阶段自动触发，无需手动调用

在 CI/CD 或部署流程中，可追加安全清理步骤：

拾贝

一键同步微信读书所有笔记和划线，并在新标签页回顾

186 查看详情

删除所有 .md、.txt、.rst 文档文件：find vendor/ -name "*.md" -delete
移除 PHP 测试相关目录和文件：find vendor/ -path "*/tests" -o -path "*/Tests" -o -name "*Test.php" -o -name "phpunit.xml*" | xargs rm -rf
注意：避免误删 vendor/autoload.php 或 vendor/composer 目录

清理后建议快速检查是否影响功能：

基本上就这些。合理配置 + 插件辅助，能让 vendor 缩减 30%~60% 体积，尤其对大型项目效果明显，又不破坏运行稳定性。

以上就是如何清理 Composer vendor 目录中不必要的文件（如文档、测试）来减小项目体积？的详细内容，更多请关注php中文网其它相关文章！