autoload-dev是专为测试类等开发代码配置的自动加载规则，仅在开发环境生效，与require-dev控制的测试依赖无关；它通过psr-4等映射使Tests等命名空间下的类可被自动加载，需配合composer dump-autoload --dev生效。
autoload-dev 不是“测试依赖”，而是“测试类的自动加载规则”
很多人误以为 autoload-dev 是用来装 PHPUnit 或 Mockery 这类工具的——其实不是。autoload-dev 只管「哪些测试类文件能被 PHP 自动找到」，和「是否安装 phpunit/phpunit」完全无关。后者由 require-dev 控制，前者只影响 class_exists()、new TestsUnitExampleTest() 这类行为是否成功。
常见错误现象：
- 已安装
phpunit/phpunit，但运行vendor/bin/phpunit报Class 'TestsUnitExampleTest' not found - CI 构建通过，本地却跑不通测试——大概率是漏了
composer dump-autoload --dev
根本原因：Composer 把 autoload-dev 的映射编译进 vendor/composer/autoload_dev.php，而这个文件只在开发环境的 autoloader 中被引入；生产环境的 vendor/autoload.php 里压根没有它。
psr-4 是最安全的 autoload-dev 配置方式
用 psr-4 映射测试类，IDE 补全好、路径语义清晰、且 Composer 能自动感知新增/删除的类文件（只要目录结构合规）。
正确写法示例：
"autoload-dev": {
"psr-4": {
"Tests\": "tests/"
}
}
必须满足的条件：
-
tests/Unit/ExampleTest.php文件内必须声明namespace TestsUnit;（末尾不加反斜杠） - 路径
"tests/"是相对于composer.json所在目录的绝对路径，不能写成./tests/或../tests/ - 不要和主
autoload.psr-4的命名空间冲突，比如"App\Tests\": "tests/"和"App\": "src/"共存时，AppTestsExampleTest必须真实存在于tests/下，不能放在src/Tests/
files 和 classmap 容易引发重复加载问题
files 和 classmap 在 autoload-dev 中有用，但风险更高。
files 会强制在每次加载 vendor/autoload.php 时执行 require_once，典型场景是 tests/helpers.php 里的全局函数。但如果你在 phpunit.xml 的 <bootstrap> 里又写了同一文件，就会触发两次加载，导致 Cannot redeclare function 错误。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
classmap 则适合非标准结构的老项目，比如 tests/bootstrap.php 没有命名空间、只是纯脚本。但它有个硬伤：新增测试类文件后，必须手动再跑一次 composer dump-autoload --dev，否则不会被扫描到。
建议原则：
- 优先用
psr-4，除非你明确需要files的立即执行特性，或classmap的无命名空间兼容性 - 避免在
autoload-dev.files和phpunit.xml.bootstrap中同时引入同一个文件 - CI 环境中，如果用了
classmap，记得在composer install后补上composer dump-autoload --dev
CI/CD 中 autoload-dev 生效的关键命令
很多 CI 流水线只执行 composer install，却没意识到：默认情况下，composer install 不会生成 autoload_dev.php，除非显式启用 dev 模式或运行 dump 命令。
推荐 CI 步骤：
-
composer install --no-interaction --prefer-dist（安装所有依赖，含require-dev） -
composer dump-autoload --dev --optimize（仅重生成 dev autoloader，并启用优化）
验证是否生效的小技巧：检查 vendor/composer/autoload_dev.php 文件末尾，是否出现了你配置的路径数组项，例如：
'Tests\' => array($vendorDir . '/myproject/tests'),
如果没出现，说明 dump-autoload --dev 没执行，或者 composer.json 语法有误（比如多了一个逗号）。
最常被忽略的一点：即使 autoload-dev 配得再准，只要没运行 dump-autoload --dev，它就只是 JSON 里的几行文字，对 PHP 解释器完全透明。
