XAMPP 自带的 PHPUnit 3.x 不兼容 PHP 8+ 和 Composer 项目，因其不支持命名空间、@dataProvider 等现代语法，且易与 vendor/autoload.php 冲突；应改用 Composer 在项目内安装并配置 phpunit.xml 的 bootstrap。
直接在 XAMPP 里用自带的旧版 PHPUnit（比如 3.x）会报错、不兼容现代 PHP 代码，尤其是 PHP 8+ 和 Composer 项目。必须手动替换或重装，不能依赖 XAMPP 自带的 PHPUnit 或 PHPUnit2 目录。
为什么 XAMPP 自带的 phpunit 不能直接用
XAMPP 1.7.x–2.0.x 版本捆绑的 PHPUnit 是 3.x 甚至更老的分支，早已停止维护；它不支持 PHPUnit\Framework\TestCase 命名空间，也不识别 @dataProvider、yield 数据提供者等现代语法；运行时大概率抛出 Class 'PHPUnit_Framework_TestCase' not found 或 ParseError: syntax error。
- PEAR 安装方式在新版 XAMPP 中常因
go-pear.phar过期而失败 -
[XAMPP]/php/PEAR/PHPUnit目录若残留，会干扰 Composer 自动加载 - 即使强制 require，也会和
vendor/autoload.php冲突，导致类重复定义或找不到
推荐做法：用 Composer 在项目内安装（不碰 XAMPP 系统级配置）
绕过 XAMPP 的 PEAR 体系，完全走 Composer 流程，最稳定、可复现、且与 IDE（如 PhpStorm / VS Code）调试无缝衔接。
- 确保 XAMPP 的
php.exe已加进系统PATH（例如C:\xampp\php），终端执行php -v和composer --version都能正常输出 - 进入你的项目根目录（不是
htdocs，而是你实际写代码的那个文件夹），运行：composer require --dev phpunit/phpunit ^10
（PHP 8.1+ 推荐^10；若用 PHP 7.4，请改用^9.5） - 安装后，测试入口就是：
vendor/bin/phpunit（Windows 下是vendor\bin\phpunit.bat） - 别试图把
phpunit.phar放进php.exe同目录并设全局命令——容易和多个项目版本冲突
phpunit.xml 配置必须显式指定 bootstrap
很多教程漏掉关键点：XAMPP 默认没开自动加载，不配 bootstrap 就会报“class not found”，哪怕类文件明明存在。
立即学习“PHP免费学习笔记（深入）”；
- 在项目根目录新建
phpunit.xml，内容至少包含：<?xml version="1.0" encoding="UTF-8"?> <phpunit bootstrap="vendor/autoload.php"> <testsuites> <testsuite name="default"> <directory>tests</directory> </testsuite> </testsuites> </phpunit> -
bootstrap="vendor/autoload.php"是硬性要求，不能省；XAMPP 不会自动读取 Composer 的 autoload 规则 - 如果测试类用到了框架（如 Laravel、Yii），需额外在
bootstrap文件里引入框架启动逻辑，不能只靠autoload.php
运行时常见错误及对应修复
遇到红色报错别急着重装，先看这几条高频原因：
- 报
Warning: require_once(PHPUnit/Autoload.php)：说明还在调旧版路径，删干净[XAMPP]/php/PEAR/PHPUnit*目录，重启终端 - 报
Class 'PHPUnit\Framework\TestCase' not found：确认phpunit.xml里bootstrap路径正确，且vendor/autoload.php确实存在（运行过composer install） - 报
PHP Fatal error: Uncaught Error: Class "Tests\CalculatorTest" not found：检查测试文件命名是否为CalculatorTest.php（末尾必须是Test.php），且类名与文件名严格一致 - Windows 下执行
vendor/bin/phpunit报“不是内部或外部命令”：改用php vendor/bin/phpunit显式调用解释器
真正麻烦的从来不是装不上，而是旧残留路径和新 Composer 自动加载之间的静默冲突——删干净再重来，比调半天 PEAR 权限靠谱得多。
