Composer如何设置autoload-dev_Composer开发加载独立配置方式【详解】-composer-PHP中文网

autoload-dev 是独立于 autoload 的开发专用加载规则，必须作为 composer.json 顶层字段配置，仅在启用 --dev 时生效；混用或错配将导致类无法加载且难以排查。

composer如何设置autoload-dev_composer开发加载独立配置方式【详解】

autoload-dev 不是用来“补全”主 autoload 的，它是完全独立的一套加载规则，只在开发环境生效。配错位置、漏掉 --dev 参数、或和 autoload 混用命名空间，都会导致类找不到却查不出原因。

它必须是 composer.json 的一级字段，和 autoload、require-dev 并列。拼成 autoloadDev、放在 require-dev 里、或者缩进两层，Composer 都会直接忽略整个配置。

正确位置："autoload-dev": { "psr-4": { "Tests\": "tests/" } }
错误写法："require-dev": { "autoload-dev": { ... } }（被无视）
错误写法："autoloadDev": { ... }（大小写敏感，不识别）
验证方式：运行 composer dump-autoload --dev 后，打开 vendor/autoload.php，搜索 Tests\ 看是否注册成功

psr-4 是测试类的默认选择；classmap 只适合无命名空间、结构散乱的辅助文件。混用时要注意 classmap 会优先命中，可能绕过 psr-4 规则。

Workflow Decomposer

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

下载

用 psr-4：所有测试类必须严格匹配路径与命名空间，例如 Tests\Unit\UserTest → tests/Unit/UserTest.php，且末尾必须带反斜杠："Tests\"
用 classmap：适用于 tests/bootstrap.php、tests/helpers/ 这类没 namespace 或含多个函数的文件，但每次增删文件都得重跑 composer dump-autoload --dev
别混用同一目录：比如同时配置 "Tests\": "tests/"（psr-4）和 "tests/Helper.php"（classmap），Helper.php 里的类即使没声明 namespace Tests 也会被加载，且无法被其他命名空间引用

composer dump-autoload 默认只处理 autoload，对 autoload-dev 完全无感。不加 --dev，改了等于白改。

必须执行：composer dump-autoload --dev（推荐）或 composer install --dev
CI/CD 中容易漏：如果部署脚本用了 composer install --no-dev，那 autoload-dev 根本不会写入 vendor/autoload.php，phpunit 必然失败
本地验证快捷方式：var_dump(class_exists('TestsTestCase'));，返回 true 才算真正生效
检查映射是否生成：composer show -s | grep Tests

files 列表里的 PHP 文件会在每次加载 vendor/autoload.php 时被 require_once，不是“按需加载”，而是无条件执行。

适合放纯函数定义文件，比如 tests/functions.php 里只有 function assertJsonContains(...)
不适合放 tests/bootstrap.php：它常含数据库连接、Mock 初始化等副作用逻辑，会被反复执行
更安全的做法：把 bootstrap 逻辑封装进一个类，再用 psr-4 加载，由测试启动器显式调用
files 在 composer install --no-dev 时会被跳过，但 classmap 和 psr-4 映射仍会生成（只是对应文件不复制）——这点极易被忽略

最常被忽视的其实是部署环节：哪怕配置全对，只要上线命令漏了 --no-dev，autoload-dev 的映射就会进生产环境，测试类、桩代码、调试工具全跟着打包进去——体积变大、性能下降、还可能暴露攻击面。