autoload-dev 不能写在主 autoload 里，因为其专为开发依赖服务，需与生产环境自动加载隔离；混入主配置会导致 --no-dev 时仍加载测试类，引发线上 fatal error。
autoload-dev 为什么不能写在主 autoload 里
因为 autoload-dev 是专为开发依赖（require-dev）服务的，和生产环境的自动加载逻辑必须隔离。如果混进主 autoload，运行 composer install --no-dev 时，这些开发类仍会被生成到 vendor/autoload.php 的映射中，导致生产环境意外加载测试类、Mock 类甚至触发 fatal error。
常见错误现象：Class MockeryMockInterface not found 在线上报错，但你确认没装 mockery —— 实际是 autoload-dev 里的规则把它的命名空间塞进了生产 autoloader。
-
autoload下的规则影响所有环境（含--no-dev） -
autoload-dev只在composer install或composer update且未加--no-dev时生效 - 两者生成的 PSR-4 映射分别写入
vendor/composer/autoload_psr4.php的不同数组段，互不干扰
怎么写才算“分离”：路径、命名空间、文件模式全对齐
分离不是光挪个配置块，关键在于路径不重叠、命名空间不冲突、文件不被生产代码引用。比如你的测试类放在 tests/，对应命名空间 Tests\，那 autoload-dev 就只管这一块，绝不能写成 "": "src/" 这种宽泛映射。
正确示例：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"Tests\": "tests/",
"Example\TestFixtures\": "tests/fixtures/"
},
"files": [
"tests/helpers.php"
]
}
}
-
autoload-dev中的psr-4命名空间必须以\结尾（如"Tests\"），否则 Composer 解析失败 -
files列表里的脚本只在开发环境被require_once，别放任何有副作用的初始化逻辑 - 路径必须真实存在，Composer 不校验，但后续
phpunit找不到类时只会静默失败
执行 composer dump-autoload 后没生效？检查这三处
composer dump-autoload 默认只处理 autoload，不碰 autoload-dev —— 这是最常踩的坑。它只在 install/update 时自动合并 dev 部分，手动刷新必须加 --dev。
- 运行
composer dump-autoload --dev才会重新生成 dev 相关映射 - 如果用了
classmap模式，autoload-dev中的classmap路径必须指向具体目录或文件，不能是通配符 - 修改
autoload-dev后没运行任何命令？Composer 不监听 json 变更，不执行就等于没改
测试类被生产代码引用了怎么办
这是设计层面的泄漏，比配置错误更危险。即使 autoload-dev 隔离得再干净，只要生产代码里写了 new TestsFooTest()，上线后必崩。
解决思路不是绕过自动加载，而是从代码组织上切断依赖：
- 用接口 + 依赖注入替代直接 new 测试类（例如把 fixture 构造逻辑抽成
FixtureFactory接口，生产实现空逻辑） - 所有
Tests\命名空间下的类加 PHPDoc@internal，配合静态分析工具（如 PHPStan）拦截误引 - CI 中加检查：
grep -r 'namespace Tests' src/，发现即 fail
真正难的从来不是怎么写配置，而是让开发路径和生产路径在代码层就物理隔离。一旦开始在 src/ 里 use Tests，autoload-dev 再规范也没用。
