PHPUnit 变慢甚至失败的根本原因是 --optimize-autoloader 将 tests/ 路径写入主 classmap，导致体积膨胀、命名空间冲突及动态类加载失败；正确做法是分离 autoload_dev.php、禁用测试路径 classmap、显式声明 psr-4 并在 phpunit.xml 中 bootstrap 它。
对 PHPUnit 运行时自动加载做优化，核心不是加 --optimize-autoloader，而是让测试类不进主 autoload、避免 classmap 扫描污染、并确保 autoload_dev.php 独立加载。
为什么 composer install --optimize-autoloader 会让 PHPUnit 变慢甚至失败
它会把 autoload-dev 里的路径（比如 "tests/"）也扫进 vendor/composer/autoload_classmap.php，但 PHPUnit 启动时默认用的是 vendor/autoload.php —— 这个文件在优化后会优先走 classmap，而 classmap 里混着生产类+测试类，导致：
- classmap 文件体积暴涨（多几百个测试类），PHP 每次 require 都得反序列化/解析整个大数组
- 测试类路径若和生产命名空间冲突（如
TestsFooTest和AppTestsFooTest），classmap 可能只录一个，造成“找不到类”却报错位置诡异 - 某些测试依赖运行时动态生成类（如 Mockery、OrchestraTestbench 的临时类），classmap 不支持，直接挂掉
正确做法：分离 autoload_dev.php 并禁用测试路径的 classmap
PHPUnit 应该只加载 autoload_dev.php，而不是主 autoload.php。这需要两步配合：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保
composer.json中autoload-dev是独立块，且没和autoload共享路径（例如不要写"psr-4": {"": "src/"}再加"tests/"到 dev 里——""会把tests/也扫进去） - 删掉
autoload-dev里所有classmap声明；改用psr-4显式声明测试命名空间，例如："Tests\": "tests/" - 运行
composer dump-autoload（不带-o），确认生成了vendor/autoload_dev.php，且里面调用了$loader->setUseIncludePath(false) - 在
phpunit.xml中指定 bootstrap：<php><include path="vendor/autoload_dev.php"/></php>
CI/CD 中避免踩坑的关键参数组合
部署测试环境时，别用 --no-dev —— 它会直接删掉 autoload_dev.php。应该用：
-
composer install --prefer-dist（保证依赖完整） -
composer dump-autoload（不加-o，保持 dev 路径可热更新） - 确保 PHP 的 opcache 开启且
opcache.enable_cli=1（否则每次 PHPUnit 启动都要重编译 autoload_dev.php） - 如果项目用了
files类型加载（比如全局 helper 函数），检查它们是否在autoload-dev里 —— 否则autoload_dev.php不会包含它们，测试中调用就报Call to undefined function
最常被忽略的一点：即使你写了 "Tests\": "tests/"，如果 tests/ 目录下有 Bootstrap.php 这种非标准命名类（没命名空间或命名空间不匹配），Composer 仍可能把它扫进 classmap —— 最稳妥的方式是把这类文件移出 tests/，或用 exclude-from-classmap（仅 Composer ≥5.0 支持）显式排除。
