autoload-dev 与 autoload 是两套独立系统，前者仅在开发环境生效且需显式执行 composer dump-autoload --dev 才能更新；phpunit 需通过 phpunit.xml 中 bootstrap="vendor/autoload.php" 触发 autoload-dev 加载。

autoload-dev 和 autoload 是两套完全独立的加载系统

很多人以为在 autoload 里配了 "App": "src/"，测试类放 tests/ 就能自动加载——其实不会。Composer 明确区分生产与开发环境：autoload 生成的映射只进 vendor/autoload.php，而 autoload-dev 的内容默认不写入这个文件，也不会出现在生产构建中。

这意味着：

• composer install --no-dev 后，vendor/autoload.php 里压根没有 Tests 的任何映射
• 即使你手动 require vendor/autoload.php，它也只加载 autoload 规则，autoload-dev 不生效
• autoload-dev 的映射实际写入的是 vendor/composer/autoload_dev.php，只有特定入口才会加载它

phpunit 运行时如何触发 autoload-dev

PHPUnit 默认不会自动加载 autoload-dev，除非你明确告诉它“用哪个 autoloader 启动”。关键不在命令本身，而在启动方式：

• phpunit 命令行直接运行（如 vendor/bin/phpunit tests/）时，它会尝试读取 phpunit.xml 或 phpunit.xml.dist
• 必须在 <phpunit></phpunit> 标签里声明 bootstrap="vendor/autoload.php" —— 注意不是 autoload.php 或相对路径
• 这个 vendor/autoload.php 文件内部会判断当前是否在 dev 模式（通过 ComposerAutoloadClassLoader::setDevMode(true)），然后主动加载 autoload_dev.php
• 如果用自定义 bootstrap 脚本（如 tests/bootstrap.php），里面必须写 require __DIR__.'/../vendor/autoload.php';，且 phpunit.xml 的 bootstrap 属性要指向它

autoload-dev 配置写错的典型表现

报 Class "TestsUnitExampleTest" not found，但文件明明存在、命名空间也对，问题往往出在配置细节：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 写成 "Tests": "tests/"（缺末尾反斜杠）→ Composer 解析为根命名空间 Tests，不匹配 TestsUnit
• 写成 "Tests": "tests"（路径缺末尾斜杠）→ 拼出 testUnit/ExampleTest.php，而非 tests/Unit/ExampleTest.php
• 目录名是 Tests/，但配置写 "Tests": "tests/" → Linux/macOS 下大小写不一致，路径找不到
• 混用 psr-4 和 classmap 在 autoload-dev 里 → Composer 不 fallback，psr-4 匹配失败就直接报错，不会退到 classmap 扫描

改了 autoload-dev 必须显式执行 dump-autoload --dev

composer install 或 composer update 默认只处理 autoload，autoload-dev 不会被重生成。漏掉这步，vendor/composer/autoload_dev.php 就还是旧的，新加的测试类永远不被识别。

验证是否生效最直接的方式：

• 运行 composer dump-autoload --dev
• 打开 vendor/composer/autoload_dev.php，搜索你的命名空间前缀（如 'Tests\'），确认映射数组已更新
• 在 CI 中加一句检查： php -r "echo class_exists('TestsUnitExampleTest') ? 'ok' : 'fail';"

最容易被忽略的一点：--dev 参数不能省，composer dump-autoload 默认不碰 autoload-dev。