composer怎么设置autoload-dev_composer开发环境自动加载【分离】

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/",             "ExampleTestFixtures": "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 再规范也没用。