PHPUnit需正确安装并配置：执行./vendor/bin/phpunit（Linux/macOS）或vendorinphpunit（Windows），按PHP版本选对应PHPUnit版本，配置phpunit.xml指定测试路径，并在composer.json中设置autoload-dev以确保类自动加载。
直接用 composer require --dev phpunit/phpunit 就能装上，但实际跑起来常报错、找不到测试类、或版本不兼容——核心问题不在“装没装”，而在“装对不对”和“怎么连得上”。
为什么 composer require phpunit/phpunit 装完却执行不了 phpunit 命令
因为 Composer 默认把二进制命令（如 phpunit）装在 vendor/bin/ 下，不是全局可执行的。你直接敲 phpunit，系统根本找不到这个命令。
- ✅ 正确做法：运行
./vendor/bin/phpunit（Linux/macOS）或vendorinphpunit（Windows） - ⚠️ 别用
composer global require phpunit/phpunit：容易污染全局环境，不同项目 PHP 版本或依赖冲突时会互相打架 - ? 想省事？加个 alias：
alias pu='./vendor/bin/phpunit'，然后用pu代替
安装时选哪个版本才不踩坑
PHPUnit 和 PHP 版本强绑定。装错版本，轻则警告，重则 Class 'PHPUnitFrameworkTestCase' not found 直接报错。
- PHP 8.2+ → 用
phpunit/phpunit:^10.5或^11.0 - PHP 8.0–8.1 → 推荐
phpunit/phpunit:^9.6（LTS 版本，稳定且文档全） - PHP 7.4 → 只能用
^8.5，再高就语法报错 - ❌ 别无脑
--latest：Composer 默认可能拉到不兼容的主版本
怎么让 PHPUnit 自动找到你的测试文件
默认情况下，./vendor/bin/phpunit 会找当前目录下 *Test.php 文件里的 Test 类，但实际项目结构往往更复杂。
立即学习“PHP免费学习笔记（深入）”；
- 必须加配置文件
phpunit.xml或phpunit.xml.dist，否则它只扫当前目录 - 最小可用配置示例：
<?xml version="1.0" encoding="UTF-8"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd">
<testsuites>
<testsuite name="default">
<directory>tests</directory>
</testsuite>
</testsuites>
<source>
<include>
<directory>src</directory>
</include>
</source>
</phpunit>
-
<directory>tests</directory>告诉它去哪找测试类；<source></source>是为了自动加载被测代码 - 路径是相对于
phpunit.xml所在位置的，别写成绝对路径
常见报错和对应解法
装完一跑就挂？大概率是这几个点没对上：
-
Warning: Failed to load config file "phpunit.xml"→ 当前目录没有phpunit.xml，也未指定--configuration -
Class 'TestsUnitExampleTest' not found→ 测试类没加namespace TestsUnit;，或autoload-dev没配自动加载规则 -
Call to undefined method PHPUnitFrameworkTestCase::assertEquals()→ 用了旧写法（如$this->assertEqual()），PHPUnit 9+ 已移除，统一用assertEquals() - Windows 下提示
'phpunit' is not recognized→ 不是环境变量问题，是路径写错了，一定要用vendorinphpunit（反斜杠），别抄 Linux 的斜杠
最易被忽略的是 autoload-dev 配置：如果 tests/ 下的类要引用 src/ 里的代码，就得在 composer.json 里加上：
"autoload-dev": {
"psr-4": {
"Tests\": "tests/"
}
}
然后跑一次 composer dump-autoload —— 否则 TestCase 找得到，你自己写的测试类反而加载失败。
