关键在autoload.php路径、phpunit.xml识别和自动加载配置：需指定vendor/autoload.php、将phpunit.xml置于根目录并标记为配置文件、在composer.json中正确配置autoload-dev映射Tests命名空间至tests/目录、执行composer dump-autoload -o，并将tests目录标记为Test Sources Root。
直接运行失败、右键没反应、覆盖率显示0%——这些问题90%不是代码写错了，而是 PhpStorm 没真正“连上” PHPUnit 的加载链路。关键不在“装没装”，而在 vendor/autoload.php 是否被正确指定、phpunit.xml 是否被识别、测试类是否能被 Composer 自动加载到。
PhpStorm 找不到 TestCase 类？先查 autoload-dev 和目录标记
报错 Class 'PHPUnitFrameworkTestCase' not found 或 Class 'TestsUnitExampleTest' could not be found，本质是 PHP 运行时根本没加载到这个类。
- 检查
composer.json的autoload-dev是否把Tests命名空间映射到了tests/目录，例如："Tests\": "tests/" - 测试类文件路径必须和命名空间严格匹配：声明
namespace TestsUnit;，那文件就得放在tests/Unit/ExampleTest.php - 改完
composer.json后必须执行composer dump-autoload -o，否则 PhpStorm 和 CLI 都不会更新类索引 - 在 PhpStorm 中右键
tests目录 → Mark Directory as → Test Sources Root（变成绿色图标），否则 IDE 不会把它当测试入口
phpunit.xml 不生效？路径、命名、标记三者缺一不可
PhpStorm 不会自动扫描子目录找配置文件，它只认项目根目录下名为 phpunit.xml 或 phpunit.xml.dist 的文件，大小写一个字母都不能错。
- 用终端确认文件真实存在：
ls -la phpunit.*（Linux/macOS）或dir phpunit.*（Windows） - 打开该文件，确认顶层标签是
<phpunit></phpunit>，不能只有 XML 声明（<?xml ...?>） - 在 PhpStorm 中右键点击该文件 → 选 Mark as PHPUnit Configuration File；如果菜单里没有这项，说明 PHP 插件未启用，或 PhpStorm 版本太旧（
- 若用自定义配置，进
Settings → Tools → PHP → Test Frameworks，勾选 Use custom configuration file 并指定绝对路径
Run with Coverage 显示 0%，Xdebug 配置只是基础条件
覆盖率数据依赖 Xdebug（或 PCOV），但 PhpStorm 的图形化视图还额外要求启动方式和设置对齐。
立即学习“PHP免费学习笔记（深入）”；
- 必须通过右键菜单里的 Run with Coverage 启动（不是普通 Run），否则不采集数据
- 进
Settings → Tools → Coverage，确认 Coverage runner 设为Xdebug—— 即使你实际用的是 PCOV，当前 PhpStorm 版本（截至 2026.4）仍只认 Xdebug 为驱动 - 验证 CLI 是否真启用了 Xdebug：
php -v输出中应含with Xdebug v3.x，且php --ini显示的配置文件里已启用zend_extension=xdebug.so -
phpunit.xml中的<filter><whitelist>必须明确包含被测源码路径，比如<directory suffix=".php">./src</directory>
测试方法不执行？命名、继承、属性支持版本都要卡准
右键某个 testAddition() 方法却提示 “No tests found”，大概率是 PHPUnit 解析器和 PhpStorm 对不上号。
- PHPUnit 9+ 强制要求测试类继承
PHPUnitFrameworkTestCase，且方法名以test开头；若用@test注解，需确保方法是 public 且无参数 - 若用 PHP 8.1+ 的
#[Test]属性，PhpStorm 版本必须 ≥ 2022.3，否则直接忽略该方法 - 确保
phpunit.xml里有有效的<testsuites>块，例如：<directory suffix="Test.php">./tests</directory>，否则扫描逻辑失效 - 临时验证法：在 Terminal 里手动跑
./vendor/bin/phpunit tests/ExampleTest.php，成功了再回头查 PhpStorm 配置
最常被忽略的其实是 composer dump-autoload -o 这一步——改了命名空间、加了新测试类、挪了目录结构，不刷新 autoload 映射，PhpStorm 和 CLI 就永远“看不见”它，所有配置都白搭。
