autoload-dev 是独立于 autoload 的开发专用自动加载配置，仅在启用 dev 模式（未加 --no-dev）时写入 vendor/autoload.php，用于加载测试、Mock、Fixture 等非生产代码。
Autoload-dev 是什么，它和 autoload 有什么本质区别？
autoload-dev 不是 autoload 的“增强版”或“备用方案”，而是完全独立的自动加载配置区块，只在 composer install 或 composer update 时启用 dev 模式（即未加 --no-dev）才会被写入 vendor/autoload.php。一旦你运行 composer install --no-dev，autoload-dev 里的所有映射都会被跳过，对应类文件根本不会被注册进自动加载器。
这意味着：测试类、Mock 类、Fixture 类这些仅用于开发/测试的代码，放在这里既安全又合理——生产环境压根看不到它们。
如何正确配置 autoload-dev 映射？路径、命名空间、类型全说清
常见错误是把测试类目录直接映射到根命名空间（如 ""），结果导致 MyTest 被解析为全局类，PHP 报 Fatal error: Class 'MyTest' not found。正确做法是让命名空间与目录结构严格对齐。
- 若测试类放在
tests/Unit/DatabaseTest.php，且文件内声明namespace AppTestsUnit;，则应配置：
{
"autoload-dev": {
"psr-4": {
"App\Tests\": "tests/"
}
}
}
-
psr-4是最常用类型；classmap适合无命名空间的旧测试脚本（如tests/bootstrap.php中的函数库），需显式指定路径：
{
"autoload-dev": {
"classmap": ["tests/helpers/"]
}
}
- 不要混用
psr-4和psr-0（已废弃）；也不要在autoload-dev里重复定义autoload已覆盖的命名空间，否则可能引发冲突或覆盖。
为什么 vendor/autoload.php 在测试中能加载 dev 类，但 PHPUnit 运行时报错？
典型现象：phpunit 执行时提示 Class 'AppTestsUnitDatabaseTest' not found，即使 composer dump-autoload 已成功运行。问题往往出在启动方式上。
- 确保你没有手动 require 错误的 autoloader —— 应该用
vendor/autoload.php，而不是项目根目录下自己写的bootstrap.php（除非它明确引入了 vendor/autoload.php） - 检查 PHPUnit 配置文件
phpunit.xml是否覆盖了自动加载行为：
<phpunit bootstrap="vendor/autoload.php">
<testsuites>
<testsuite name="Unit">
<directory>tests/Unit</directory>
</testsuite>
</testsuites>
</phpunit>
- 如果使用
phpunit --bootstrap vendor/autoload.php命令行参数，也要确认当前工作目录下vendor/autoload.php确实存在且已生成（即 composer 已执行过且未加--no-dev）
autoload-dev 加载失败的三个高频排查点
不是配置写错了，就是环境没对上。这三个地方卡住最多：
- 运行
composer install时加了--no-dev，导致autoload-dev完全没生效；用composer show -s可验证是否启用了 dev 包，但更直接的是看vendor/autoload.php文件末尾是否包含你定义的psr-4注册逻辑 -
tests/目录下的 PHP 文件没有namespace声明，或命名空间与autoload-dev中的键不匹配（比如配了"App\Tests\"，但文件里写的是namespace TestsUnit;） - 类名与文件名大小写不一致（尤其在 macOS/Linux 下敏感）：如类名
DatabaseTest，文件必须叫DatabaseTest.php，不能是databasetest.php
autoload-dev 的边界很清晰：它只管“能不能加载”，不管“该不该运行”。真正决定测试是否执行的是 PHPUnit 的 suite 配置和文件发现逻辑。别指望靠改 autoload-dev 来跳过某个测试文件——那得去动 phpunit.xml 或注解。
