应使用 composer require --dev phpunit/phpunit 局部安装，避免全局安装导致版本混乱；需在项目根目录执行 composer install，检查 vendor/bin/phpunit 是否生成，并配置 phpunit.xml 指定 bootstrap 和 tests 目录。
直接用 composer require --dev phpunit/phpunit 就行，别碰全局安装
PHPUnit 不是系统级工具，也不是 CLI 全局命令型项目，强行全局装（比如 composer global require phpunit/phpunit）会导致版本混乱、PHP 版本不匹配、CI 环境失败。所有现代 PHP 项目都应走 --dev 局部依赖路线，这样 vendor/bin/phpunit 路径确定、版本锁定在 composer.lock 里，CI/CD 和协作者才能一致运行。
常见错误现象：phpunit: command not found —— 很大概率是因为你没进项目根目录，或者没执行 composer install（只 run 了 require 但没装依赖）。
- 必须在项目根目录下运行，且该目录存在
composer.json - 执行后检查
vendor/bin/phpunit是否生成（不是vendor/phpunit/phpunit） - 如果报错
phpunit/phpunit requires php ^8.1这类，说明你本地 PHP 版本太低，别硬升 PHPUnit 版本去迁就旧 PHP，先升级 PHP
安装时指定版本，避免默认拉最新版踩坑
Composer 默认会装最新稳定版，但 PHPUnit 10+ 强制要求 PHP 8.1+，且移除了对 assertArraySubset() 等常用断言的支持；而很多老项目还卡在 PHP 7.4 或用了这些被删函数。不锁版本，CI 构建某天突然失败，你根本不知道谁动了啥。
使用场景：维护 Laravel 8/9、Symfony 5.x、或自研框架的老项目。
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PHP 7.4 项目 → 用
composer require --dev phpunit/phpunit:^9.6 - PHP 8.0 项目 →
composer require --dev phpunit/phpunit:^9.6或^10.5（^10.0开始已弃用expectException()的字符串写法） - 想验证是否装对？运行
vendor/bin/phpunit --version
phpunit.xml 配置文件必须手写，别信 vendor 里自带的默认配置
Composer 安装完不会自动帮你生成 phpunit.xml，而没有它，phpunit 会按默认规则扫描整个 ./ 目录，可能误跑非测试文件，或漏掉 tests/ 下的子目录。更糟的是，不显式声明 bootstrap，测试里 use AppSomething; 会直接报 Class not found。
最小可用配置示例（存为项目根目录下的 phpunit.xml）：
<?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"
bootstrap="vendor/autoload.php"
colors="true">
<testsuites>
<testsuite name="default">
<directory>tests</directory>
</testsuite>
</testsuites>
</phpunit>
-
bootstrap必须指向vendor/autoload.php，否则类自动加载失效 -
<directory>tests</directory>是约定路径，别写成test或Tests（大小写敏感，Windows 可能侥幸通过，Linux 直接跳过） - 如果项目用 Composer 自定义了 autoload（如
"psr-4": {"App\": "src/"}），确保composer dump-autoload已执行
运行测试前，先确认 vendor/bin/phpunit 是可执行文件
Windows 用户常遇到：明明装好了，运行 vendor/bin/phpunit 却提示“不是内部或外部命令”，这是因为 Windows 不识别 Unix 风格的 shebang 脚本。Composer 在 Windows 下会额外生成一个 phpunit.bat，但某些 Composer 版本或 Git Bash 环境下它可能没生成或权限不对。
- 优先用
php vendor/bin/phpunit（显式调用 PHP 解释器，全平台通用） - Mac/Linux 下若提示
Permission denied，运行chmod +x vendor/bin/phpunit - CI 中（如 GitHub Actions）务必用
php vendor/bin/phpunit，别省php前缀 - 别用
./vendor/bin/phpunit在 Windows PowerShell 里跑 —— 它会尝试当脚本执行，而不是传给 PHP
最麻烦的其实是 autoload 和命名空间没对齐，报错看着像 PHPUnit 问题，实际是 tests/Feature/HomeTest.php 里 use AppHttpControllersHomeController; 找不到——这种得回头查 composer.json 的 autoload 配置和目录结构是否真对应上了。
