需先运行 composer require --dev phpunit/phpunit，再配置 phpunit.xml.dist（非.xml），设 bootstrap="vendor/autoload.php"、tests 和 src 路径，并确保 composer.json 中 autoload 的 psr-4 映射与类命名空间一致，否则 ci 因 --no-dev 导致 class not found。
怎么装 PHPUnit 并让它真正跑起来
直接在包根目录运行 composer require --dev phpunit/phpunit，别跳过 --dev。装完后必须有 phpunit.xml.dist（不是 .xml），否则 composer test 很可能静默失败或加载错路径。
关键配置项只有三个：用 bootstrap="vendor/autoload.php" 确保能加载你的类；<directory>tests</directory> 指明测试入口；<source><directory>src</directory></source> 告诉 PHPUnit 哪儿找被测代码。漏掉 <source></source>，覆盖率和 IDE 跳转常出问题。
- 别用
./vendor/bin/phpunit直接跑——它不读phpunit.xml.dist的<source></source>，会导致 “Class not found” - 本地跑测试前先确认
composer dump-autoload --no-dev能通过，CI 里这步失败=测试根本起不来 - 如果类名是
MyPackageCalculator，但phpunit.xml.dist里没配psr-4映射或映射路径错，class_exists('MyPackageCalculator')就会返回false
为什么本地 test 能过，CI 却报 “Class not found”
根本原因：CI 默认执行 composer install --no-dev，而你的 autoload-dev（比如测试基类 tests/Support/TestCase.php）不会被加载——但更隐蔽的问题是，**主命名空间 autoload 没配对**。
例如 src/ 下的类属于 MyPackage，但 composer.json 里只写了："autoload": { "psr-4": { "App\": "src/" } }，那 CI 就永远找不到 MyPackageCalculator。
- 检查点：运行
composer show my/package，看输出里autoload那行是否匹配你实际类的命名空间 - CI 中加一行验证命令：
composer dump-autoload --no-dev && php -r "echo class_exists('MyPackage\Calculator') ? 'ok' : 'fail';" - 别把测试辅助类（如
TestCase）放进autoload-dev后又在src/里use它——生产 autoload 不包含autoload-dev，CI 必炸
怎么写一个靠谱的测试类结构
不是“建个 tests/ 文件夹扔几个 *Test.php”就行。核心是路径、命名空间、继承三者对齐。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
假设你的类在 src/Http/Client.php，命名空间是 MyPackageHttp，那么测试文件必须是 tests/Http/ClientTest.php，命名空间为 MyPackageTestsHttp，且继承 PHPUnitFrameworkTestCase。
- 文件名必须以
Test.php结尾，类名必须以Test结尾，否则 PHPUnit 自动发现机制失效 - 别在
tests/里用require_once手动引文件——依赖自动加载，否则本地能过、CI 因路径差异失败 - 边界测试比 happy path 更重要：空数组、
null参数、异常分支，这些地方最容易在 CI 里暴露 autoload 或逻辑漏洞
如何让 composer test 在 CI 里真正可靠
靠 "test": "phpunit" 这种脚本太脆弱。CI 里要显式控制行为，避免隐式依赖或版本漂移。
GitHub Actions 推荐用 shivammathur/setup-php（比官方 action 更稳），PHP 版本用矩阵 [8.1, 8.2, 8.3]，而不是写死 8.2；测试命令必须带 --no-coverage --fail-on-warning，否则 deprecation 警告会被忽略，等 PHP 升级就全挂。
- CI 第一步永远是
composer validate --no-check-publish，提前拦截composer.json字段错误（比如误写"autoloads"） - 别只跑
phpunit，加一行composer dump-autoload --no-dev再验证class_exists，这是最便宜的 autoload 健康检查 - 如果用了
@dataProvider，确保数据返回的是真实值，不是new stdClass()这类无法序列化的对象——某些 PHP 版本下会静默跳过该用例
最常被忽略的点：本地开发时你可能开了 OPCache 或 IDE 自动 reload，但 CI 是干净容器。任何依赖“已加载类缓存”或“未声明的全局函数”的测试，在 CI 里第一秒就失败。
