autoload-dev 是 composer.json 中专用于开发/测试环境的自动加载配置，与 autoload 隔离；误用会导致生产环境加载测试类、内存浪费及副作用；需执行 composer dump-autoload --dev 生效，并避免 bootstrap.php 重复加载。
autoload-dev 是什么，为什么不能写进 autoload
autoload-dev 是 composer.json 中一个独立字段，专用于声明「仅在开发/测试时需要自动加载的类」，比如 tests/ 下的测试用例、src/Tests/ 中的测试工具类、或 stubs/ 里的模拟类。它和 autoload 互不干扰：生产环境执行 composer install --no-dev 时，autoload-dev 的规则会被完全忽略，对应路径也不会出现在生成的 vendor/autoload.php 中。
如果误把测试类塞进 autoload，会导致生产环境无意义地加载大量测试代码，增大内存占用，还可能触发未预期的副作用（比如自动执行测试中的静态初始化逻辑）。
正确配置 autoload-dev 的三种常用方式
根据测试目录结构选择匹配方式，优先用 psr-4，兼容性好且支持命名空间映射；classmap 适合零散文件或非标准命名；files 仅用于必须提前载入的函数文件。
-
psr-4：最常用，适用于标准测试目录，如tests/MyApp/FeatureTest.php对应命名空间MyAppTests -
classmap：适合tests/bootstrap.php或tests/helpers/*.php这类无命名空间、无固定结构的辅助文件 -
files：仅用于纯函数文件（如tests/functions.php），会强制在每次autoload.php加载时require_once
{
"autoload": {
"psr-4": {
"App\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"App\Tests\": "tests/",
"MyApp\Stubs\": "tests/stubs/"
},
"classmap": [
"tests/bootstrap.php",
"tests/helpers/"
],
"files": [
"tests/functions.php"
]
}
}
运行测试前必须执行 dump-autoload
修改 autoload-dev 后，不会自动生效。Composer 不会在每次 require 时动态解析 JSON，而是将所有规则编译进 vendor/composer/autoload_dev.php 和 vendor/autoload.php。漏掉这步会导致测试类报 Class not found 错误。
- 执行
composer dump-autoload（简写composer du）即可重新生成 - 如果只改了
autoload-dev，加--dev参数更精准：composer dump-autoload --dev - CI 环境中建议显式加上
--optimize提升加载速度：composer dump-autoload --dev --optimize
常见陷阱：bootstrap.php 被重复加载
很多项目在 autoload-dev.files 里引入 tests/bootstrap.php，又在 PHPUnit 配置（phpunit.xml）的 Cannot redeclare function 或 Constant already defined。
- 二选一：要么删掉
autoload-dev.files里的bootstrap.php，只靠 PHPUnit 的 - 要么删掉
phpunit.xml中的 - 若 bootstrap 中有依赖 autoloader 的代码（如 new TestClass()），必须确保它在 autoloader 之后执行 —— 此时只能走 PHPUnit 的
autoload-dev.files是在 autoloader 初始化阶段就require_once的
测试环境的 autoload 配置本质是「隔离 + 显式」：隔离生产与开发的加载边界，显式声明哪些路径只对谁可见。最容易被忽略的是 dump-autoload --dev 这一步，以及 bootstrap.php 的双重加载问题 —— 它们不会报语法错误，但会让测试在本地跑通、CI 失败，或者偶尔成功偶尔失败。
