autoload-dev 专用于开发测试环境,配合 require-dev 使用,执行 composer install --no-dev 时完全忽略;autoload 则面向生产环境,所有环境均生效。

autoload-dev 和 autoload 都是 Composer 用来声明 PHP 类自动加载规则的配置项,但它们的服务对象、生效时机和部署影响完全不同——尤其在测试环境配置中,这个区别直接决定代码是否能跑通、会不会被误发到线上。
服务场景不同
autoload 是为生产环境设计的,它定义的命名空间(如 App\ → src/)会在所有环境下生效,只要引入 vendor/autoload.php 就会加载。而 autoload-dev 专为开发与测试环境服务,比如 PHPUnit 运行时、本地调试或 CI 测试阶段才起作用;一旦执行 composer install --no-dev,它的全部规则都会被跳过,连生成的自动加载映射里都不会出现。
配置内容通常不一样
autoload 一般映射业务核心代码,例如:
"App\\": "src/""Vendor\\Package\\": "vendor/package/src/"
autoload-dev 则常见于这些路径:
-
"Tests\\": "tests/"—— 让测试类可被直接 new 或 use -
"DevTools\\": "dev-tools/"—— 调试用工具类,不进生产包 - 用
files加载tests/helpers.php这类全局函数文件
和 require-dev 协同工作
autoload-dev 不单独起作用,它常配合 require-dev 使用:
- require-dev 声明开发期依赖(如 phpunit、faker、phpstan)
- autoload-dev 告诉 Composer:这些依赖要用的类、以及项目自己的测试类,该怎么自动加载
- 运行
composer install --no-dev时,不仅不装 require-dev 的包,也不会处理 autoload-dev 的映射,vendor/autoload.php 里完全不包含它们
对测试流程的实际影响
没有正确配置 autoload-dev,测试很可能报错“Class not found”:
- PHPUnit 找不到
Tests\Unit\ExampleTest,因为Tests\\没映射到tests/ - 测试辅助类(如
TestDataFactory)无法自动加载,只能靠手动 require,破坏 PSR-4 规范 - CI 环境若漏掉
--no-dev,可能把测试数据工厂类一起打包上线,带来安全隐患










