先确认tests目录是否标记为test sources root（绿色图标），再检查phpunit是否配置为composer autoloader并指向vendor/autoload.php，确保phpunit.xml在根目录且被标记为配置文件、顶层为标签，同时coverage需通过“run with coverage”启动且coverage runner设为xdebug。
PhpStorm 里“Run Tests in directory”没反应？先确认目录是否被识别为测试根
右键点击 tests 目录 → Mark Directory as → Test Sources Root，图标变成绿色才算生效。如果还是灰色或没这选项，说明 PHP 插件没启用（Settings → Plugins 检查 PHP 是否已启用），或者项目没识别为 PHP 项目（File → Project Structure → Project → Project SDK 必须设为 PHP 解释器）。
为什么选中目录后右键只有“Run”没“Run Tests in xxx”？检查 PHPUnit 配置是否绑定 autoloader
进 Settings → Tools → PHP → Test Frameworks，点击 + → 选 PHPUnit by Composer autoloader，然后在 Path to autoloader 填项目根目录下的 vendor/autoload.php（不是 vendor/bin/phpunit，也不是 .phar 文件）。填错路径会导致 PhpStorm 根本不加载测试类，右键菜单就只剩普通 Run。
- 如果
vendor/autoload.php还不存在，先跑composer install或composer dump-autoload -o - 别选
PHPUnit library或Global installation，这两项绕过 Composer 加载链，90% 触发Class 'PHPUnit\Framework\TestCase' not found - 确保
phpunit.xml在项目根目录，且顶层标签是<phpunit></phpunit>；右键该文件 →Mark as PHPUnit Configuration File
想批量跑 tests/Unit 下所有测试，但只跑了一部分？看 phpunit.xml 的 <directory></directory> 是否覆盖到位
打开 phpunit.xml，确认 <testsuites></testsuites> 内有类似这样的配置：
<testsuites><testsuite name="Unit"><directory>tests/Unit</directory></testsuite></testsuites>
如果只写了 <directory>tests</directory>，它会递归扫描整个 tests/，但若你只想跑 Unit 子目录，就必须显式指定路径。PhpStorm 的“Run Tests in directory”功能依赖这个配置做范围裁剪，不是单纯按文件系统遍历。
- 路径大小写必须完全一致：Linux/macOS 下
tests/unit≠tests/Unit - 如果用了
<exclude></exclude>或<file></file>节点，可能意外屏蔽了某些文件 - 临时验证：终端里执行
./vendor/bin/phpunit tests/Unit，成功了再回 PhpStorm 查配置
Run with Coverage 显示 0%，但单个测试能跑通？覆盖率启动方式和 Xdebug 设置必须对齐
覆盖率不是“开了 Xdebug 就自动有”，而是需要两个硬性条件同时满足：
- 必须通过右键菜单里的
Run with Coverage启动（不是普通Run） -
Settings → Tools → Coverage中的Coverage runner必须选Xdebug（即使你实际用的是 PCOV，当前 PhpStorm 版本仍只认 Xdebug 为驱动） - 确认 CLI PHP 已启用 Xdebug：
php -v输出含xdebug，且php -m | grep xdebug有结果
最常被忽略的一点：PhpStorm 的 Coverage 图形视图只对“当前运行配置”生效——如果你改过测试目录或配置文件，得重新右键触发 Run with Coverage，不能复用上次的运行记录。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
