可配置 composer 的 archive 选项或使用 composer-cleaner 插件自动剔除非运行必需文件以减小 vendor 体积；archive 配置仅对 dist 包生效，插件支持自定义清理规则并自动触发，配合部署脚本可进一步精简，最终缩减 30%~60% 体积。
可以配置 Composer 的 archive 选项或使用插件，在安装/更新时自动剔除文档、测试、git 目录等非运行必需文件，从而显著减小 vendor 体积。
启用 Composer 内置的 archive 配置
在项目根目录的 composer.json 中添加 archive 配置，控制从包中排除哪些路径：
- 支持通配符，如
"exclude": ["/tests", "/Tests", "/docs", "/Docs", "/.*", "/phpunit.xml", "/CHANGELOG.*"] - 该配置仅对从 Packagist 下载的 zip 包生效（即
"dist"源），对"source"（git clone）无效 - 修改后需重新执行
composer install或composer update才会生效
使用 composer-cleaner 插件（推荐）
这是一个轻量、专注清理的第三方插件，能自动删除常见冗余内容：
- 安装：
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 或部署流程中，可追加安全清理步骤：
- 删除所有
.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目录
验证清理效果与注意事项
清理后建议快速检查是否影响功能：
- 运行
composer dump-autoload确保自动加载正常 - 执行关键业务逻辑或单元测试（如果有的话），确认无类找不到错误
- 不建议在开发环境激进清理，因为 ide 跳转、调试、阅读源码可能依赖文档和测试示例
- 若某包因清理导致异常，可在
composer.json中用"preserve-paths"单独保留其特定目录
基本上就这些。合理配置 + 插件辅助，能让 vendor 缩减 30%~60% 体积，尤其对大型项目效果明显，又不破坏运行稳定性。
以上就是如何清理 Composer vendor 目录中不必要的文件（如文档、测试）来减小项目体积？的详细内容，更多请关注php中文网其它相关文章！