autoload-dev用于隔离开发依赖，避免测试代码进入生产环境。它支持PSR-4、classmap、files等方式，如配置tests/目录下的测试类，通过composer dump-autoload生成加载文件，仅在开发时生效；执行composer install –no-dev时自动忽略，确保生产环境安全高效。
环境配置额外自动加载规则的字段。它不会被包含在生产环境的自动加载中，专为测试类、工具类或本地开发用的辅助代码服务。
为什么需要 autoload-dev？
项目在开发过程中常常会使用 phpUnit 测试、PHPStan 静态分析、本地调试脚本等工具，这些工具依赖的类文件不需要部署到生产环境。如果把这些路径加到主 autoload 中，会导致生产自动加载范围变大，影响性能，甚至暴露测试代码。
autoload-dev 允许你把测试相关的类（如 tests/ 目录下的 TestCase）加入自动加载，只在开发时生效。
如何配置 autoload-dev？
在 composer.json 中添加该字段，结构与 autoload 完全一致，支持 psr-4、psr-0、classmap、files 等方式：
{ "autoload": { "psr-4": { "app\": "src/" } }, "autoload-dev": { "psr-4": { "App\Test\": "tests/", "Tests\": "tests/" }, "files": [ "tests/helpers.php" ], "classmap": [ "test-stubs/" ] } }
配置完成后运行：
composer dump-autoload
Composer 会生成对应的自动加载文件，开发时就能直接使用测试类而无需手动引入。
实际应用场景
- PHPUnit 测试类位于
tests/Unit和tests/Feature，通过 autoload-dev 加入 PSR-4 映射，可直接运行测试 - 编写 PHP CLI 调试脚本放在
dev-tools/，通过 files 方式自动加载辅助函数 - 使用 Mockery 或自定义桩代码（stubs），用 classmap 扫描加载
注意点
执行 composer install --optimize-autoloader --no-dev 时（典型于生产环境构建），Composer 不会安装 require-dev 包，也不会写入 autoload-dev 的配置。这样能确保测试相关类不会被加载，提升安全性和性能。
基本上就这些。合理使用 autoload-dev，能让开发更高效，同时保持生产环境干净。不复杂但容易忽略。