--no-dev模式下autoload-dev被忽略,仅加载autoload内容,用于隔离开发依赖。执行composer install --no-dev时跳过require-dev包,不生成autoload-dev映射,排除dev路径,防止生产环境引入测试或开发类,避免Class not found错误。

在使用 Composer 的 --no-dev 模式时,autoload-dev 配置会被完全忽略。
dev 自动加载配置的作用范围
autoload-dev 字段中定义的类或文件仅在开发环境下加载,比如用于单元测试、代码分析工具或开发辅助类。这些内容不会被包含进生产环境的自动加载机制中。
常见写法如下:
"autoload-dev": {"psr-4": {
"Tests\\": "tests/"
}
}
--no-dev 对 autoload 的影响
执行 composer install --no-dev 或 composer update --no-dev 时,Composer 会:
- 跳过
require-dev中声明的所有包 - 不生成与
autoload-dev相关的自动加载映射 - 从
vendor/composer/autoload_psr4.php等自动加载文件中排除 dev 路径
这意味着即使你手动引入了 tests 目录下的类,PHP 也无法通过自动加载找到它们,除非你额外配置。
实际构建中的表现
在部署生产环境时,推荐使用 --no-dev 来减小 vendor 目录体积并避免引入不必要的开发依赖。此时,Composer 生成的自动加载器只包含 autoload 中定义的内容。
如果你在非测试环境中意外引用了 dev 命名空间下的类(如 Tests\ExampleTest),PHP 会抛出 Class not found 错误,因为这些路径未被注册到自动加载器中。
基本上就这些。--no-dev 模式下,autoload-dev 完全不参与自动加载系统的构建,这是设计上的隔离机制。










