Composer安装时过滤无用测试文件及文档减少Disk占用的参数调优-composer-PHP中文网

composer install --no-dev 无法删除 vendor 中的 tests/ 目录，因为它仅跳过 require-dev 声明的包（如 phpunit/phpunit），但不干预正式依赖包（如 symfony/console）内部自带的 tests/ 等非运行文件——这些是包作者源码的一部分，composer 默认原样解压；真正排除需依赖 archive.excludes 配置或 composer-archive-excludes 插件在 dist 解压阶段过滤。

composer安装时过滤无用测试文件及文档减少disk占用的参数调优

composer install --no-dev 为什么删不掉 vendor 里的 tests/ 目录

因为 --no-dev 只跳过 require-dev 区块声明的包（比如 phpunit/phpunit），但对已安装的正式依赖（如 monolog/monolog）内部是否含 tests/、docs/ 完全不管——这些目录是包作者源码的一部分，Composer 默认原样解压。

常见错误现象：vendor/ 占用 150MB+，其中 symfony/console 下的 Tests/ 目录就占 20MB，但运行时根本不会加载它。

--no-dev 是必须加的，但它只是第一步，不是“瘦身”本身
真正起作用的是安装方式：如果走 dist（zip 包），才可能利用 .gitattributes 规则过滤；走 source（git clone）则完全绕过裁剪
确认当前安装方式：运行 composer install -v，看日志里出现的是 Downloading ... .zip 还是 Cloning ...

用 archive.excludes 配置在解压阶段跳过 tests/docs

这是最干净、可复现的方式——在 zip 包解压前就排除路径，不落地、不残留。它只对 dist 安装生效（即默认行为），且需写进项目级配置，不是全局设置。

执行以下命令启用：

composer config archive.excludes '["tests/*", "Tests/*", "test/*", "docs/*", "examples/*", ".github/*", ".git"]'

注意：archive.excludes 是数组格式字符串，引号和括号缺一不可；路径通配符只支持 *，不支持 ** 或正则。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

该配置会写入当前项目的 composer.json 的 config 块，不影响其他项目
下次 composer install 时，所有从 dist 下载的包都会按此规则解压（前提是包发布者用了 zip 格式）
不生效？检查包是否真走 dist：有些包（尤其 dev 版本或 fork）强制走 source，此时 archive.excludes 完全无效

用 composer-archive-excludes 插件替代手动 rm

比起 post-install-cmd 里写 find vendor -name tests -exec rm -rf {} +，插件更可靠：它在 Composer 解压 ZIP 的瞬间就过滤路径，避免“先写再删”的冗余 IO 和权限问题。

安装插件：

composer require --dev composer-archive-excludes/composer-archive-excludes

插件自动读取 archive.excludes 配置（如果已设），无需额外配置。它兼容 Composer 2.5+，且不干扰 autoload 逻辑。

不要和 post-install-cmd 清理脚本共存，否则可能重复删、报错中断
Windows 用户注意：插件依赖 PHP 的 zip 扩展，确保 php -m | grep zip 有输出
验证是否生效：安装后进某个包目录（如 vendor/monolog/monolog），直接 ls 看是否存在 tests/ —— 没有就是成功

--optimize-autoloader 和 --classmap-authoritative 不删文件，但能缩小实际体积

--optimize-autoloader（或 -o）生成 vendor/autoload_classmap.php，只包含被 autoload 声明实际引用的类；--classmap-authoritative 则强制只从此 classmap 加载，彻底跳过文件系统扫描。它们不删除 tests/ 目录，但会让这些目录“不可见”——Docker 构建时 COPY vendor 后，运行时根本不会访问它们，相当于白占空间。

生产环境推荐组合使用：

composer install --no-dev --optimize-autoloader --classmap-authoritative --prefer-dist

--prefer-dist 强制走 zip 包，确保 archive.excludes 或插件能起作用
--classmap-authoritative 对只读文件系统（如容器 rootfs）很关键，避免因 opendir() 失败导致 fatal error
别指望 --optimize-autoloader 减小磁盘占用——它只加速加载，du -sh vendor 数值几乎不变

真正见效的点不在参数开关，而在你是否控制了安装源头：dist 包 + archive.excludes（或插件）是唯二能在文件落地前就过滤掉 tests/ 的手段；事后用脚本删，总会有漏网之鱼，比如某些包把测试放在 src/Tests 里，而 autoload 又没声明它——这种路径既不被加载，也不被插件识别，只能靠人工判断。