autoload 是生产必需，autoload-dev 仅限开发；前者声明运行时必须加载的类（如控制器），后者仅覆盖测试、工具类等绝不上线的代码，执行 composer install --no-dev 时自动跳过。
autoload 是生产环境的“必需品”，autoload-dev 是开发时的“临时工”
autoload 声明的是你的包或应用在运行时**必须能加载到的类**，比如 src/Http/Controller.php 里的控制器；而 autoload-dev 只负责那些**永远不该出现在线上**的代码，比如 tests/Feature/LoginTest.php 或 stubs/DatabaseStub.php。它们不是“两个可选配置”，而是环境隔离的硬性边界。
- 执行
composer install --no-dev（生产部署常用）时，autoload-dev的全部规则被跳过，对应路径不会写入vendor/autoload.php -
autoload中误塞进测试类，可能导致线上启动时触发PHPUnitFrameworkTestCase的静态初始化，直接报错Class "PHPUnitFrameworkTestCase" not found - PHPStan、PHP_CodeSniffer 等工具依赖
autoload-dev加载测试辅助类；若漏配，会提示Class XXX not found却查不到原因
怎么配 autoload-dev？只加三类东西就对了
别想复杂——autoload-dev 就是给“不跑在线上但开发时要能 new 出来的类”开的绿色通道。官方推荐结构里，它通常只覆盖：
-
tests/目录下的所有测试用例（PSR-4 映射到Tests\命名空间） -
src/Tests/或src/Support/Testing/这类开发专用工具类 -
stubs/、factories/、seeds/等仅用于本地构建或测试的数据模拟文件（可用files类型加载）
示例 composer.json 片段：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"autoload-dev": {
"psr-4": {
"Tests\": "tests/",
"App\Tests\": "src/Tests/"
},
"files": ["stubs/helpers.php"]
}
dump-autoload 不加 --no-dev，autoload-dev 就白配了
很多人改完 autoload-dev 后跑测试还是找不到类，其实只是忘了刷新自动加载映射。默认 composer dump-autoload 会把 autoload-dev 也编进去；但上线前你得主动剔除它：
- 本地开发：直接
composer dump-autoload（含autoload-dev） - CI/CD 或部署脚本中：必须加
--no-dev，即composer dump-autoload --no-dev - 如果用了
optimize（已废弃）或--classmap-authoritative，更要确认--no-dev是否生效，否则 classmap 里仍残留测试路径
require-dev 和 autoload-dev 必须成对理解
require-dev 装的是 PHPUnit、Mockery 这些**工具本身**；autoload-dev 加的是你写的、要被这些工具**调用的代码**。两者缺一不可，但作用域完全不同：
- 删掉
require-dev里的phpunit/phpunit→ 测试命令./vendor/bin/phpunit找不到 - 删掉
autoload-dev里的"Tests\": "tests/"→phpunit能跑，但所有use Tests*全报错 - 把测试类挪进
autoload并保留require-dev→ 线上composer install --no-dev仍会加载测试类，浪费内存且可能触发副作用（比如 DB 连接初始化）
最常被忽略的一点：autoload-dev 不是“可有可无的便利配置”，它是 Composer 对“环境契约”的强制表达——写错位置，轻则 CI 报错，重则线上行为异常，而且问题往往延迟暴露。
