根本原因是ci默认执行composer install --no-dev，只加载autoload段而忽略autoload-dev，导致测试基类无法被src中代码引用；需检查autoload命名空间一致性、启用dev autoload、使用composer test而非直接调用phpunit，并在ci中验证dump-autoload。
CI 里 composer test 报 “Class not found” 怎么快速定位
根本不是 PHPUnit 配置问题，而是 composer.json 的 autoload 和 CI 实际加载行为不一致。CI 默认执行 composer install --no-dev，只生效 autoload 段，完全忽略 autoload-dev —— 所以你写的 tests/Support/TestCase.php 即使能被本地加载，CI 里也压根不存在。
排查优先级如下：
- 运行
composer show your-vendor/your-package，确认输出中autoload行的命名空间（如"MyPackage\": "src/"）和你实际类的命名空间（如MyPackageCalculator）**逐字符一致**，大小写、反斜杠、末尾是否带都不能错 - 检查
composer.json的autoload-dev.ps4是否存在多余层级（比如写成"MyPackageTests\": "tests/"，但文件里是namespace MyPackageTestsHttp），路径必须严格对应目录结构 - CI 脚本开头加一句验证：
composer dump-autoload --no-dev && php -r "echo class_exists('MyPackage\Calculator') ? 'ok' : 'fail';"—— 这行挂了，后面所有测试都白跑
为什么本地 phpunit 能过，CI 却找不到测试类
因为本地你大概率直接跑了 ./vendor/bin/phpunit，它会读 phpunit.xml.dist，而这个文件里可能写了 bootstrap="vendor/autoload.php" —— 但这个 vendor/autoload.php 是由 composer install --dev 生成的，含 autoload-dev；CI 里没装 dev 依赖，vendor/autoload.php 就不含测试类路径。
正确做法是统一走 composer test，并确保 composer.json 中定义为：
"scripts": {
"test": "vendor/bin/phpunit"
}
这样无论本地还是 CI，都强制通过 Composer 的脚本机制执行，且能继承其环境一致性。别写成 "test": "phpunit"，除非你确定 PATH 里永远有 vendor/bin。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
phpunit.xml.dist 必须配齐的三项
漏掉任意一项，CI 就可能静默失败或类加载异常：
-
bootstrap="vendor/autoload.php"：必须是这个路径，不能是空字符串、相对路径或自定义 bootstrap 文件（除非你明确控制加载顺序） -
<directory>tests</directory>：PHPUnit 扫描入口，必须是tests（不是test、Tests或tests/Unit） -
<source><directory>src</directory></source>：没有它，--coverage-html会漏覆盖率，某些上下文里class_exists()也可能返回false
特别注意：.dist 后缀是约定，PHPUnit 默认优先读 phpunit.xml；如果项目里误存了一个空的 phpunit.xml，CI 就会跳过 .dist，导致配置失效。
GitHub Actions 里最易被忽略的三处硬伤
缓存、PHP 扩展、autoload 生成，这三项错一个，CI 就不可靠：
- 缓存 key 必须用
composer-${{ hashFiles('**/composer.lock') }}，不能只缓存vendor/目录——不同 PHP minor 版本间vendor/不兼容，会导致随机 autoload 失败 - PHP 扩展不能靠系统默认，必须显式声明：
extensions: mbstring, xml, ctype, json, openssl, zip；缺mbstring或xml，phpunit启动就退出 -
composer install后必须补一句composer dump-autoload --no-dev --optimize，否则即使依赖装上了，类映射也可能没更新或没优化，尤其在矩阵构建中容易因缓存残留出问题
CI 不是本地环境的镜像，它是更严苛的验证场——所有“应该自动发生”的事，都得显式写出来。比如 dump-autoload 不是可选项，是必跑步骤；--no-dev 不是省资源，是防止生产代码意外依赖测试类。
