ThinkPHP单元测试需严格匹配版本、正确配置phpunit.xml并使用php think unit执行。TP5.0/5.1须用对应think-testing版本，TP6推荐直装phpunit；phpunit.xml必须位于根目录且含正确的tests；测试类需命名规范、加命名空间，禁删TestCase.php。
ThinkPHP 的单元测试组件不是“装上就能跑”，关键在于版本对齐和路径连通。直接 composer require topthink/think-testing 很可能失败或后续执行报错，原因基本就三点：TP 版本与测试扩展不匹配、PHPUnit 版本被自动拉高、phpunit.xml 没生效或路径写错。
确认你的 TP 版本再选测试扩展
ThinkPHP 5.0.x 和 5.1.x 使用的 think-testing 扩展版本完全不同，强行混用会直接导致 Class 'Tests\Unit\ExampleTest' not found 或 TestCase 类加载失败：
- TP 5.0.x → 必须用
topthink/think-testing:^1.0（例如composer require topthink/think-testing:^1.0.7） - TP 5.1.x → 要用
topthink/think-testing:^2.0 - TP 6.x → 已内置测试支持，推荐直接
composer require --dev phpunit/phpunit:^9.6，不用装think-testing
查当前 TP 版本：打开 thinkphp/library/think/App.php，看顶部注释里的 @version；或者运行 php think version（需已配置命令行环境）。
phpunit.xml 文件必须存在且路径正确
安装 think-testing 后，它会自动生成 phpunit.xml 和 tests/ 目录，但这个文件极易被忽略或覆盖。一旦缺失或内容错误，php think unit 就会静默失败或报 Warning: Failed to load config file "phpunit.xml"：
- 确保
phpunit.xml在项目根目录（和composer.json同级），不是在tests/里 - 检查
<directory>tests</directory>这一行——它指明测试类位置，不能写成./tests或绝对路径 - 如果手动删过
tests/TestCase.php，php think unit会直接报错，这个基类不能动
最小可用 phpunit.xml 示例（TP 5.0/5.1）：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
<?xml version="1.0" encoding="UTF-8"?><phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nonamespaceschemalocation="https://schema.phpunit.de/9.5/phpunit.xsd"><testsuites><testsuite name="unit"><directory>tests</directory></testsuite></testsuites><source><include><directory>app</directory></include></source></phpunit>
执行测试时别直接敲 phpunit
phpunit 命令本身不会自动识别 ThinkPHP 的自动加载规则，硬跑会报 Class 'think\App' not found。官方封装的 php think unit 是唯一推荐入口：
- 必须在项目根目录下执行，不是
tests/或app/ - 确保
think可执行文件有权限（Linux/macOS 下chmod +x think） - Windows 用户若提示
'php' is not recognized，说明 PHP 没进环境变量，改用完整路径：D:\xampp\php\php.exe think unit - 想临时跳过某测试？在测试方法前加
@group skip，然后执行php think unit --group skip
常见报错速查与修复点
以下错误出现频率极高，基本对应一个明确动作：
-
Could not find driver [sqlite]→ TP 单元测试默认用 SQLite，但 PHP 缺少pdo_sqlite扩展，启用它即可 -
file_get_contents(): SSL operation failed→ Composer 源没切国内镜像，运行composer config -g repo.packagist composer https://packagist.phpcomposer.com -
Class 'PHPUnit\Framework\TestCase' not found→ PHPUnit 版本太高（如装了 ^10.x），降级：composer require --dev phpunit/phpunit:^9.6 -
Tests\Unit\ExampleTest::testExample显示为未执行 → 测试类没加namespace Tests\Unit;，或文件名不是ExampleTest.php（必须以Test.php结尾）
真正卡住的地方往往不是“没装”，而是 phpunit.xml 路径错、TestCase.php 被删、或 php think unit 没在根目录执行——这三个点反复核对，比重装十次都管用。
