autoload-dev 是 composer.json 中专用于开发环境的自动加载配置，其映射不会写入生产环境的 vendor/autoload.php；而 autoload 的配置在所有环境中生效。
autoload-dev 是什么，和 autoload 有什么区别
是
中一个独立配置项，专门用于定义「仅在开发环境生效」的自动加载规则。它和
的核心区别在于：Composer 安装依赖时，
的映射**不会写入生产环境的
自动加载器中**——除非你显式执行
或未加
标志。
这意味着：
目录下的类，在 CI 或线上部署时默认不可被
或
，能有效避免测试代码意外进入生产逻辑。
如何在
composer
.
js
on 中正确配置 tests/ 目录自动加载
最常用且推荐的方式是使用
映射，把测试命名空间与目录明确绑定。例如你的项目根命名空间是
，测试类放在
下：
配置后需运行
生效。注意以下几点：
后面的双反斜杠是必需的，表示命名空间结尾，否则可能匹配到
等子命名空间
路径是相对于
所在目录的，不能写成
或绝对路径
如果测试类没有按 PSR-4 规则命名（比如文件名不匹配类名），自动加载会失败，此时应改用
什么时候该用 classmap 而不是 psr-4
当你有以下情况时，
更可靠：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
测试目录里混着函数文件（如
）、匿名类或非标准命名类
使用了 PHPUnit 的
后缀但类名不完全遵循命名空间层级（如
中定义的是
而非
）
想让某个目录下所有 PHP 文件无条件被扫描并注册（适合快速原型或遗留结构）
示例配置：
注意：
生成的是静态路径列表，每次增删测试文件后必须重新运行
，否则新文件不会被加载。
常见错误：测试类找不到、Class not found、autoload.
php
不包含 tests
典型现象包括：
，或在 GitHub Actions 中跑测试时报错但本地正常。排查要点：
确认当前执行环境是否启用了 dev 包：CI 中常带
，导致
被跳过
检查
是否真包含
映射：可临时加一行
查看输出
留意大小写——Linux 下
和
是不同路径，但 Windows 可能不报错，造成本地通过、CI 失败
如果你用的是 Composer 2.2+ 并启用了
，确保
映射仍被保留（它默认只优化
，不影响
）
测试类的自动加载看似简单，但跨环境一致性往往卡在路径大小写、CI 参数和 dump-autoload 的触发时机上。
autoload-devcomposer.jsonautoloadautoload-devvendor/autoload.phpcomposer install --dev--no-devtests/requirenewpsr-4MyApptests/
{
"autoload": {
"psr-4": {
"MyApp\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"MyApp\Tests\": "tests/"
}
}
}
composer dump-autoloadMyApp\Tests\MyApp\TestSuite\tests/composer.json./tests/classmapclassmaptests/helpers.phpTesttests/Unit/HelperTest.phpHelperTestMyAppTestsUnitHelperTest
{
"autoload-dev": {
"classmap": ["tests/", "tests/bootstrap.php"]
}
}
classmapcomposer dump-autoloadPHP Fatal error: Class 'MyAppTestsUnitExampleTest' not found--no-devautoload-devvendor/autoload.phptests/var_dump($loader->getPrefixesPsr4());Tests/tests/optimize-autoloaderautoload-devautoloadautoload-dev