autoload-dev 是独立于 autoload 的开发专用加载通道，必须置于 composer.json 顶层、键名精确为 autoload-dev，配合 --dev 执行 dump-autoload 并由 phpunit.xml 正确引导 vendor/autoload.php 才生效。
autoload-dev 不是 autoload 的补丁，它是独立通道；配错位置、漏加 --dev、命名空间不匹配，三者任一发生，phpunit 就会直接报 Class not found。
autoload-dev 必须写在 composer.json 顶层，且键名不能拼错
它和 autoload、require-dev 并列，不能嵌套进任何其他字段。Composer 只识别精确的 autoload-dev 字符串，大小写、缩进、层级错一点，整个配置就被静默忽略。
- ✅ 正确写法：
"autoload-dev": { "psr-4": { "Tests\": \"tests/\" } } - ❌ 错误写法：
"require-dev": { "autoload-dev": { ... } }（被无视） - ❌ 错误写法：
"autoloadDev": { ... }（大小写敏感，不识别） - 验证方式：运行
composer dump-autoload --dev后，打开vendor/autoload.php搜索Tests\，看是否注册成功
psr-4 是测试类首选，但路径与 namespace 必须严丝合缝
psr-4 不是“尽量匹配”，而是按规则硬解析：目录结构必须完全对应命名空间层级，且末尾反斜杠是强制约定（"Tests\" 表示 Tests 命名空间，不是 Tests 类名）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 文件
tests/Unit/UserTest.php必须以namespace Tests\Unit;开头（不是TestsUnit或tests\Unit） - 如果用了
"Tests\": \"tests/\"，就不能把测试类放在tests/src/Feature/这种非标准路径下 - Linux/macOS 区分大小写，
tests/unit/目录 +namespace Tests\Unit;在 Windows 下可能“碰巧”通过，但在 CI 中必然失败 - 不要用
classmap去“兜底”命名空间错误——它只会掩盖问题，且每次增删文件都得重跑composer dump-autoload --dev
改完 autoload-dev 后，必须手动执行 composer dump-autoload --dev
Composer 不会监听 composer.json 变更并自动刷新加载器。dump-autoload 默认只处理 autoload，对 autoload-dev 完全无感——不加 --dev，等于白改。
- 本地开发推荐：直接运行
composer dump-autoload --dev - CI/CD 脚本中务必确保没加
--no-dev；若用了composer install --no-dev，autoload-dev映射根本不会写入vendor/autoload.php - 快捷验证：运行
var_dump(class_exists('Tests\Unit\UserTest'));，返回true才算真正生效 - Docker 构建或 IDE 自动保存场景下，这个步骤最容易被跳过——缓存里仍是旧的
vendor/composer/autoload_dev.php
phpunit 启动时没加载 vendor/autoload.php，autoload-dev 就形同虚设
autoload-dev 的映射最终落在 vendor/autoload.php 里，但 PHPUnit 默认不自动 require 它。如果你的 phpunit.xml 没指定 bootstrap，或自定义 bootstrap 文件里没显式引入，那些映射就永远不会激活。
- 最简方案：
phpunit.xml中写<phpunit bootstrap="vendor/autoload.php"></phpunit> - 若用自定义
tests/bootstrap.php，里面必须有：require dirname(__DIR__) . '/vendor/autoload.php';（用__DIR__ . '/../vendor/autoload.php'在 symlink 或嵌套项目中会失效） - 警惕重复加载：
autoload-dev.files和phpunit.xml的<bootstrap></bootstrap>别同时指向同一个文件（如tests/bootstrap.php），否则常量重定义、函数已声明等静默崩溃无法溯源 - CI 中常见断点：PHP 缺失
ext-mbstring或ext-xml，phpunit进程启动失败，根本走不到 autoload 那步
最常被忽略的其实是“时机”：autoload-dev 的映射只在 composer install 或 dump-autoload --dev 时写入 vendor/autoload.php，而这个文件一旦生成，就不会随 composer.json 修改自动更新——哪怕你改了十次，没再执行一次命令，它就永远不知道。
