autoload-dev 是独立于 autoload 的开发专用加载规则，必须作为 composer.json 顶层字段配置，仅在启用 --dev 时生效；混用或错配将导致类无法加载且难以排查。
autoload-dev 不是用来“补全”主 autoload 的，它是完全独立的一套加载规则，只在开发环境生效。配错位置、漏掉 --dev 参数、或和 autoload 混用命名空间，都会导致类找不到却查不出原因。
autoload-dev 必须写在 composer.json 顶层，不能嵌套
它必须是 composer.json 的一级字段，和 autoload、require-dev 并列。拼成 autoloadDev、放在 require-dev 里、或者缩进两层，Composer 都会直接忽略整个配置。
- 正确位置：
"autoload-dev": { "psr-4": { "Tests\": "tests/" } } - 错误写法：
"require-dev": { "autoload-dev": { ... } }（被无视） - 错误写法：
"autoloadDev": { ... }（大小写敏感，不识别） - 验证方式：运行
composer dump-autoload --dev后，打开vendor/autoload.php，搜索Tests\看是否注册成功
psr-4 和 classmap 在 autoload-dev 里怎么选
psr-4 是测试类的默认选择；classmap 只适合无命名空间、结构散乱的辅助文件。混用时要注意 classmap 会优先命中，可能绕过 psr-4 规则。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
psr-4：所有测试类必须严格匹配路径与命名空间，例如Tests\Unit\UserTest→tests/Unit/UserTest.php，且末尾必须带反斜杠："Tests\" - 用
classmap：适用于tests/bootstrap.php、tests/helpers/这类没 namespace 或含多个函数的文件，但每次增删文件都得重跑composer dump-autoload --dev - 别混用同一目录：比如同时配置
"Tests\": "tests/"（psr-4）和"tests/Helper.php"（classmap），Helper.php 里的类即使没声明namespace Tests也会被加载，且无法被其他命名空间引用
修改后不生效？90% 是忘了加 --dev 参数
composer dump-autoload 默认只处理 autoload，对 autoload-dev 完全无感。不加 --dev，改了等于白改。
- 必须执行：
composer dump-autoload --dev（推荐）或composer install --dev - CI/CD 中容易漏：如果部署脚本用了
composer install --no-dev，那autoload-dev根本不会写入vendor/autoload.php，phpunit 必然失败 - 本地验证快捷方式：
var_dump(class_exists('TestsTestCase'));，返回true才算真正生效 - 检查映射是否生成：
composer show -s | grep Tests
files 项要小心副作用，别放初始化逻辑
files 列表里的 PHP 文件会在每次加载 vendor/autoload.php 时被 require_once，不是“按需加载”，而是无条件执行。
- 适合放纯函数定义文件，比如
tests/functions.php里只有function assertJsonContains(...) - 不适合放
tests/bootstrap.php：它常含数据库连接、Mock 初始化等副作用逻辑，会被反复执行 - 更安全的做法：把 bootstrap 逻辑封装进一个类，再用 psr-4 加载，由测试启动器显式调用
-
files在composer install --no-dev时会被跳过，但 classmap 和 psr-4 映射仍会生成（只是对应文件不复制）——这点极易被忽略
最常被忽视的其实是部署环节：哪怕配置全对，只要上线命令漏了 --no-dev，autoload-dev 的映射就会进生产环境，测试类、桩代码、调试工具全跟着打包进去——体积变大、性能下降、还可能暴露攻击面。
