应使用composer require --dev phpunit/phpunit:^9.6（php 7.4–8.0）或^10.5（php 8.1+），配置phpunit.xml.dist于项目根目录，含bootstrap="vendor/autoload.php"和tests，并执行composer dump-autoload确保自动加载生效。
直接用 composer require --dev phpunit/phpunit 装，但装完跑不起来，90% 是因为 phpunit.xml.dist 没放对位置、autoload-dev 没配或没生效、或者误用了全局 phpunit 命令。
怎么装 PHPUnit 才不会埋坑
别执行 composer require phpunit/phpunit（漏 --dev），那会把它塞进 require 区块，上线部署时白带一个测试框架，还可能污染自动加载器。
- PHP 7.4–8.0 项目：运行
composer require --dev phpunit/phpunit:^9.6 - PHP 8.1+ 项目：用
composer require --dev phpunit/phpunit:^10.5 - 装完立刻验证：
./vendor/bin/phpunit --version应输出版本号；如果报Command not found，先确认vendor/bin/目录存在，再跑一次composer install - 绝对不要
composer global require phpunit/phpunit——不同项目依赖不同主版本时，全局命令必然冲突，CI 里也默认找不到它
phpunit.xml.dist 必须放哪、写什么
文件必须放在和 composer.json 同级的项目根目录，名字必须是 phpunit.xml 或 phpunit.xml.dist。少一个字母、多一个空格，PHPUnit 就静默回退到默认扫描逻辑，大概率漏掉你的 tests/。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 最简可用配置只含三处关键：
bootstrap="vendor/autoload.php"（确保类能加载）、<directory>tests</directory>（指定入口）、<source><directory>src</directory></source>（告诉覆盖率和 IDE 哪儿找被测代码） - 漏掉
<source></source>，IDE 点不到类定义，phpunit --coverage-html也统计不出 src 下的覆盖率 -
bootstrap路径写错（比如写成autoload.php或vendor/autoload），就会报Class not found—— 不是类不存在，是自动加载根本没启动
autoload-dev 配错会导致 CI 全军覆没
本地 composer test 能过，CI 报 Class 'MyPackageCalculator' not found，八成是 composer.json 里 autoload 和 autoload-dev 没对齐，或者压根没声明 autoload-dev。
- 检查点：运行
composer show my/package，看输出里autoload行是否匹配你src/下类的实际命名空间（比如类在src/Http/Client.php，命名空间是MyPackageHttp，那composer.json的autoload就得是"MyPackage\": "src/"） -
autoload-dev必须显式声明测试类路径，例如："Tests\": "tests/"；改完后必须执行composer dump-autoload，否则新映射不生效 - CI 脚本里加一行验证：
composer dump-autoload --no-dev && php -r "echo class_exists('MyPackage\Calculator') ? 'ok' : 'fail';"，提前暴露 autoload 错位问题 - 别在
src/里use TestsSupportTestCase——autoload-dev不参与生产自动加载，CI 用--no-dev安装时，这行use就直接炸
为什么 vendor/bin/phpunit 执行时报 Class 'PHPUnitFrameworkTestCase' not found
这不是 PHPUnit 没装，而是它的类没被自动加载进来，或者你根本没走 Composer 的加载流程。
- 第一反应不是重装，而是跑
composer dump-autoload，强制重建所有映射 - 临时在
vendor/autoload.php开头加var_dump(__FILE__); exit;，确认phpunit.xml.dist的bootstrap确实指向了它 - IDE（如 PHPStorm）右键 Run 测试时，检查运行配置是否勾选了 “Use alternative configuration file”，并指向正确的
phpunit.xml.dist；否则它可能绕过 bootstrap，直接 require 单个文件 - 测试类必须继承
PHPUnitFrameworkTestCase，不是旧版PHPUnit_Framework_TestCase（已废弃，v9+ 不再兼容）
真正卡住人的地方，往往不是断言写不对，而是 phpunit.xml.dist 少了个斜杠、composer.json 里命名空间多写了反斜杠、或者 CI 脚本里忘了 composer dump-autoload 这一步——这些细节不盯住，./vendor/bin/phpunit 就永远在同一个底层错误上循环失败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
