直接用composer require --dev phpunit/phpunit安装后跑不起来，90%因配置错误：PHP版本与PHPUnit主版本不匹配（如PHP 8.1需^10.5）、phpunit.xml缺失bootstrap="vendor/autoload.php"、autoload-dev未声明tests路径、测试类未继承PHPUnitFrameworkTestCase。
直接用 composer require --dev phpunit/phpunit 装上，但跑不起来——90% 的问题出在配置没对上，不是 PHPUnit 本身有问题。
为什么 vendor/bin/phpunit 找不到测试类
根本原因不是路径错了，而是自动加载没触发或继承关系断了。
-
bootstrap="vendor/autoload.php"必须写在phpunit.xml的<phpunit>标签里，漏掉这句，use AppTestSomeClass就会报Class not found - 测试类必须显式继承
PHPUnitFrameworkTestCase，旧写法PHPUnit_Framework_TestCase在 PHP 7.4+ 已彻底废弃 - 如果项目用了 PSR-4 自动加载，得确认
tests/目录已在composer.json的autoload-dev中声明，例如："autoload-dev": { "psr-4": { "Tests\": "tests/" } } - 别手动
require或include任何文件——vendor/bin/phpunit启动时已自动加载vendor/autoload.php，重复加载会触发Cannot declare class
phpunit.xml 配置错在哪几个地方就白配
它不报错，只静默退回到默认行为（比如只扫当前目录下 *Test.php），所以你改了配置却没生效，大概率是这几个点：
- 文件名必须是
phpunit.xml或phpunit.xml.dist，且放在和composer.json同级的根目录；phpunit.xml.php、phpunit-config.xml都无效 - 别手写 DTD 声明（如
<!DOCTYPE ...>），PHPUnit 9.6+ 默认忽略 DTD，写了反而可能因网络不可达导致解析失败 -
<directory>的值是相对路径，从项目根目录算起；写成./tests/或tests/Unit都可以，但../tests这种跨级路径多数情况不工作 - 如果测试要读取环境变量（比如数据库连接），记得在
phpunit.xml里加<php><env name="DB_CONNECTION" value="sqlite"/></php>，否则$_ENV是空的
版本选错，连 TestCase 都找不到
PHP 版本和 PHPUnit 主版本强绑定，装错直接 Class 'PHPUnitFrameworkTestCase' not found，因为命名空间或语法层面就不兼容。
立即学习“PHP免费学习笔记（深入）”；
- PHP 8.2+ → 用
phpunit/phpunit:^11.0或^10.5（LTS） - PHP 8.0–8.1 → 用
phpunit/phpunit:^9.6（这是最后一个支持 PHP 8.0 的 LTS 版） - PHP 7.4 → 只能用
^8.5，再高会因mixed类型提示等语法报错 - 绝对不要用
composer require --dev phpunit/phpunit:latest—— latest 可能指向 v11，而你的 PHP 是 7.4，装完composer install就失败
运行命令为什么总是报 Command not found
不是没装，是没走对入口。Composer 不会把 phpunit 加进系统 PATH。
- 必须用
./vendor/bin/phpunit（Linux/macOS）或vendorinphpunit（Windows），不能直接敲phpunit - 如果提示
Command not found，先检查vendor/bin/目录是否存在，再执行一次composer install（有时require --dev后没重装 autoload） - 想省事可以加 alias：
alias pu='./vendor/bin/phpunit'，然后用pu；或者在composer.json的scripts里加"test": "phpunit"，之后用composer test - IDE（如 PHPStorm）右键 Run 时，务必检查运行配置是否勾选了 “Use alternative configuration file”，并指向正确的
phpunit.xml，否则它会跳过配置、只跑单个文件
最常被忽略的是 bootstrap 属性和 autoload-dev 映射——它们不报错，但一漏，整个测试就跑在“裸 PHP”环境里，连自己的类都 new 不出来。
