直接用composer require --dev phpunit/phpunit安装后无法运行，主因是PHP版本与PHPUnit主版本不匹配、未正确配置autoload-dev及执行dump-autoload、未使用./vendor/bin/phpunit（Windows为vendorinphpunit）调用，且phpunit.xml中bootstrap="vendor/autoload.php"不可缺失。
直接用 composer require --dev phpunit/phpunit 就能装上，但装完跑不了、报 Class 'PHPUnitFrameworkTestCase' not found 或 Declaration of ...::setUp(): void must be compatible——不是命令写错了，是版本没对上、路径没连通、自动加载没生效。
怎么选对 PHPUnit 版本
PHP 版本决定你能用哪个主版本，不匹配就会在运行时直接炸开：
- PHP 7.4 或 8.0 → 必须用
composer require --dev phpunit/phpunit:^9.6 - PHP 8.1（比如 Laravel 10+ 默认）→ 必须用
composer require --dev phpunit/phpunit:^10.5 - PHP 8.2+ 且项目无强框架约束 → 可试
composer require --dev phpunit/phpunit:^11.0，但注意phpunit-skeleton-generator已彻底移除，别再找phpunit-skelgen
只写 phpunit/phpunit 不带版本号？Composer 可能拉 v11.0.0，而你本地是 PHP 8.1，setUp() 签名冲突立刻报错——这不是安装失败，是硬性不兼容。
为什么 vendor/bin/phpunit 才是唯一入口
phpunit 命令找不到？正常。Composer 从不把二进制文件加进系统 PATH，它只放进项目自己的 vendor/bin/：
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS：运行
./vendor/bin/phpunit - Windows：运行
vendorinphpunit - 想统一调用？在
composer.json的scripts里加一行："test": "phpunit"，之后执行composer test即可
千万别用 composer global require phpunit/phpunit：不同项目要的版本经常打架，CI 环境默认也不认全局 bin 目录，新同事 clone 后直接跑不起来。
autoload-dev 和 dump-autoload 是什么关系
Class 'PHPUnitFrameworkTestCase' not found 这个错误，90% 不是 PHPUnit 没装好，而是你的测试类或 PHPUnit 自身类根本没被加载进来：
- 检查
composer.json里有没有这段："autoload-dev": { "psr-4": { "Tests\": "tests/" } } - 改完
autoload-dev后，必须手动运行composer dump-autoload，否则修改不生效 - 测试文件里写的是
use PHPUnitFrameworkTestCase;，不是老式的extends PHPUnit_Framework_TestCase（v9+ 已弃用） -
phpunit.xml里bootstrap="vendor/autoload.php"这行不能删——没它，use AppTestSomeClass也会报错
生成配置和验证是否真装好了
装完别急着写测试，先确认环境通了：
- 运行
./vendor/bin/phpunit --version，输出应类似PHPUnit 10.5.2 by Sebastian Bergmann - 用
./vendor/bin/phpunit --generate-configuration生成基础phpunit.xml.dist，它会帮你填对tests/路径和bootstrap - 手动创建
tests/ExampleTest.php，内容只需继承PHPUnitFrameworkTestCase并写一个断言，然后跑一次./vendor/bin/phpunit
最容易被忽略的是：改了 autoload-dev 忘了 dump-autoload，或者以为装了就能用全局命令，结果一直卡在“找不到类”或“命令未找到”——这两步漏掉，后面所有测试都白搭。
