正确做法是 composer require --dev phpunit/phpunit 并手动配置 phpunit.xml；composer install phpunit 命令不存在，因 install 不接受包名参数，且 phpunit.xml 必须位于根目录、bootstrap 路径正确、测试类须继承 PHPUnit\Framework\TestCase。
直接结论：别用 composer install phpunit，这条命令根本不存在；正确做法是 composer require --dev phpunit/phpunit + 手动配好 phpunit.xml，否则跑不起来。
为什么 composer install phpunit 会报错
这是最常踩的第一个坑——composer install 只负责安装 composer.json 里已声明的依赖，它不接受任意包名作为参数。phpunit 不是命令，而是包名，必须用 require 引入。
-
composer install phpunit→ 报错Command "install" is not defined.或类似提示 - 正确命令只有两个场景：
本地项目测试用：composer require --dev phpunit/phpunit
想全局调用（不推荐）：composer global require phpunit/phpunit - 如果提示
Could not find package phpunit/phpunit，先检查 PHP 版本（PHPUnit 10 要求 PHP ≥ 8.1），再确认能否访问 Packagist（比如curl -I https://packagist.org）
phpunit.xml 必须手写，且位置和内容都不能错
装完包不代表能跑测试——vendor/bin/phpunit 默认只扫描当前目录下以 *Test.php 结尾的文件，真实项目几乎不可能满足这个条件。必须靠 phpunit.xml 指定路径和加载逻辑。
- 文件必须放在项目根目录，名字只能是
phpunit.xml或phpunit.xml.dist（少一个字符都不认） -
bootstrap属性决定自动加载是否生效：
纯 PHP 项目用bootstrap="vendor/autoload.php"
ThinkPHP 等框架需指向bootstrap="tests/bootstrap.php"（该文件由topthink/think-testing提供） - 最简可用配置（UTF-8 编码，无 BOM）：
<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php" colors="true">
<testsuites>
<testsuite name="Unit">
<directory>tests/</directory>
</testsuite>
</testsuites>
</phpunit>
注意：<directory>tests/</directory> 路径要和你实际建的测试目录一致；如果测试文件放在 tests/Unit/，这里就得写 tests/Unit。
立即学习“PHP免费学习笔记（深入）”；
测试类继承和命名有硬性要求
即使配置全对，运行时仍可能报 Class 'PHPUnit\Framework\TestCase' not found，本质是自动加载没走通，或类写法过时。
- 测试类必须继承
PHPUnit\Framework\TestCase（PHP 7.4+），不是旧版的PHPUnit_Framework_TestCase - 文件名必须以
Test.php结尾（如CalculatorTest.php），类名去掉Test.php后缀后首字母大写（CalculatorTest→ 类名CalculatorTest） - 方法名必须以
test开头，或加@test注解；返回类型建议显式声明: void - 示例片段：
<?php
use PHPUnit\Framework\TestCase;
class CalculatorTest extends TestCase
{
public function testAddition(): void
{
$this->assertEquals(5, 2 + 3);
}
}
运行测试前务必确认入口方式
很多人在 IDE 里右键“Run”失败，不是代码问题，而是没走 Composer 的启动流程。
- 必须用
./vendor/bin/phpunit（Linux/macOS）或php vendor\bin\phpunit（Windows）执行，它内部会require vendor/autoload.php - 如果用 PHPStorm 等 IDE 运行，检查运行配置中是否勾选 “Use alternative configuration file”，路径必须指向项目根目录下的
phpunit.xml - 首次运行建议加
--verbose参数看详细加载过程：./vendor/bin/phpunit --verbose - 报
Class not found时，优先检查composer.json的autoload-dev是否包含tests/目录（尤其自定义命名空间时）
真正卡住人的地方往往不是语法，而是 phpunit.xml 放错位置、bootstrap 指向错误路径、或测试类没继承对的基类——这三个点漏掉任何一个，vendor/bin/phpunit 都只会静默失败或抛出模糊异常。
