PhpStorm 运行 PHPUnit 需正确配置自动加载器而非仅安装 PHPUnit；应通过 Settings → Tools → PHP → Test Frameworks 选择“PHPUnit by Composer autoloader”，指定 vendor/autoload.php 路径，并确保测试类继承 PHPUnit\Framework\TestCase、方法命名合规，同时覆盖率需通过“Run with Coverage”启动并启用 Xdebug。
PhpStorm 本身不自带 PHPUnit，必须手动配置才能运行测试——直接点绿色小箭头却提示 Class 'PHPUnit\Framework\TestCase' not found，基本就是没配对 autoloader 或没指定正确的 phpunit.phar 路径。
如何在 PhpStorm 中正确配置 PHPUnit 可执行文件
关键不是“装没装 PHPUnit”，而是 PhpStorm 能不能通过你指定的入口准确加载测试类和断言工具。本地用 Composer 安装的，优先选项目级 vendor/bin/phpunit；全局安装的（如 composer global require phpunit/phpunit），得确认 ~/.composer/vendor/bin/phpunit 是否在 $PATH 里，且 PhpStorm 的 Terminal 和 Test Runner 使用同一套环境变量。
- 进入
Settings > Tools > PHP > Test Frameworks - 点击
+→ 选PHPUnit by Composer autoloader - 在
Path to autoloader栏填项目根目录下的vendor/autoload.php（不是phpunit命令路径） - 若用自定义
phpunit.xml，勾选Use custom configuration file并指定路径 - 别选
PHPUnit library（旧版选项），它会绕过 Composer autoloader，极易报class not found
为什么右键 Run ‘Tests in xxx’ 没反应或报错
常见原因不是代码写错了，而是 PhpStorm 没识别出测试类结构。PHPUnit 9+ 强制要求测试类继承 PHPUnit\Framework\TestCase，且方法名必须以 test 开头或加 @test 注解；若用 #[Test] 属性（PHP 8.1+），需确保 PhpStorm 版本 ≥ 2022.3，否则解析失败。
- 检查类是否用了
use PHPUnit\Framework\TestCase;，而不是旧的PHPUnit_Framework_TestCase - 方法命名：支持
testCanAddNumbers()、canAddNumbers()（配合@test）、或#[Test] public function canAddNumbers() - 若测试文件放在
tests/但phpunit.xml里没声明<testsuites></testsuites>或<directory></directory>，PhpStorm 可能扫描不到 - 临时验证：在 Terminal 里手动跑
./vendor/bin/phpunit tests/ExampleTest.php，成功了再回头查 PhpStorm 配置
测试覆盖率显示 0%？别急着改代码
覆盖率数据依赖 Xdebug 或 PCOV 扩展，但 PhpStorm 的图形化覆盖率视图还额外要求：测试必须通过 Run with Coverage 启动（右键菜单里选这个，不是普通 Run），且 Settings > Tools > Coverage 中的 “Coverage runner” 必须设为 Xdebug（即使你用 PCOV，PhpStorm 当前版本仍只认 Xdebug 为覆盖率驱动）。
立即学习“PHP免费学习笔记（深入）”；
- 确认 PHP CLI 配置里已启用 Xdebug：
php -v输出含xdebug，且php -m | grep xdebug有结果 - PhpStorm 的
PHP > Language level和CLI interpreter必须指向同一个 PHP 可执行文件（否则 Xdebug 加载状态不一致） - 如果用了 Docker，Xdebug 需配置远程连接，且 PhpStorm 的
Settings > PHP > Servers要匹配 host/path 映射 - 覆盖率高亮只显示被测试执行到的行，未覆盖的
catch块、异常分支默认灰色，不是 bug
最常被忽略的是 phpunit.xml 里的 bootstrap 路径——它若指向一个不存在的文件，测试能跑通但覆盖率全黑；还有就是 PhpStorm 缓存了旧的测试配置，删掉 .idea/workspace.xml 里关于 testRunner 的节点再重启，有时比调半天配置更管用。
