PHP单元测试无覆盖率报告，先确认Xdebug或PCOV已启用且配置正确，再检查PhpStorm PHP解释器是否指向正确CLI版本，并确保PHPUnit实际执行了测试。
PHP单元测试跑完后没看到覆盖率报告，先检查Xdebug或PCOV是否启用
phpstorm本身不生成覆盖率数据，它只是把底层工具（xdebug 或 pcov）收集的结果可视化。如果点完“run with coverage”什么都没出来，大概率是php环境没配好。
常见错误现象：Code coverage data was not collected、覆盖率面板空白、所有文件显示为0%。
- 确认当前PHP CLI使用的扩展：运行
php -v和php -m | grep -E "(xdebug|pcov)" - Xdebug 3+ 需开启
coverage_enable=1（在php.ini或xdebug.ini中），且不能与opcache.enable=0冲突 - PCOV 更轻量，但要求 PHP ≥ 7.4，安装后需确保
pcov.enabled=1且pcov.directory="."指向项目根目录 - PhpStorm 的 PHP 解释器设置（
Settings > PHP > Interpreter）必须指向你用php -m验证过的那个 CLI 版本
Run with Coverage 点了没反应？检查测试脚本是否真被 PHPUnit 执行
覆盖率不是“点一下就出来”的魔法——它依赖 PHPUnit 实际加载并执行了你的测试类。很多情况下，PhpStorm 启动的是一个空壳，根本没跑任何测试。
使用场景：右键单个 *Test.php 文件 → Run 'xxxTest' with Coverage，但控制台只输出 Time: 00:00.000, Memory: 2.00 MB。
- 检查测试类命名是否符合 PHPUnit 默认规则：
class UserTest extends TestCase，文件名必须是UserTest.php - 确认
phpunit.xml（或phpunit.xml.dist）存在且未禁用目标目录，比如<testsuites><testsuite name="unit"><directory>tests</directory></testsuite></testsuites> - 在终端手动跑一次验证：
phpunit --coverage-text，如果报错或没输出，说明问题不在 PhpStorm，而在 PHPUnit 配置或 autoloading - PhpStorm 的测试配置里（
Edit Configurations > Test Runner），确保Test framework是PHPUnit，且Path to phpunit.phar或Autoload script指向正确位置
覆盖率报告里大量文件显示为灰色或“Not Covered”，其实是路径映射没对上
灰色 ≠ 没测，而是 PhpStorm 找不到源码和覆盖率数据之间的路径对应关系。尤其在 Docker、Vagrant 或自定义 autoload 路径时高频发生。
立即学习“PHP免费学习笔记（深入）”；
参数差异：--coverage-clover 输出的 XML 里路径是绝对路径，而 PhpStorm 默认按项目根目录匹配；如果你在容器里跑测试，XML 里的路径可能是 /var/www/src/...，但本地项目在 /Users/me/project/src/...。
- 打开
Run > Edit Configurations > Code Coverage，勾选Enable coverage for tests，再点Advanced Options - 在
Path mappings里添加映射，例如：远程路径/var/www/→ 本地路径$PROJECT_DIR$ - 如果用的是
phpunit.xml，也可在<filter>下加<path>./src</path>显式限定范围，避免扫描 vendor 或测试文件本身 - 注意：修改后要重新运行覆盖率，旧缓存不会自动刷新
为什么有些行标绿却点不开？别信颜色，看实际执行次数
绿色只表示“该行被覆盖”，不代表逻辑分支全走通。比如 if ($x) { ... } else { ... }，即使整块标绿，也可能只进了 if 分支，else 完全没触发——这种叫“部分覆盖”，PhpStorm 不会特别标黄或红，容易误判。
性能 / 兼容性影响：开覆盖率会让测试变慢 2–5 倍（Xdebug 尤甚），且可能干扰某些依赖 debug_backtrace() 或拦截异常的库。
- 别只盯着百分比数字，右键覆盖率面板 →
Go to Source，逐行看哪些分支缺失 - 对关键逻辑（如支付回调、权限校验）手动补
assertFalse($user->can('delete'))类型断言，比凑覆盖率数字更重要 - CI 环境建议用
pcov+--coverage-html产出静态报告，PhpStorm 的图形界面只适合本地快速验证
路径映射和扩展启用是两个最常卡住的地方，其他问题基本是测试没真跑起来，或者 PHPUnit 根本没加载到你的代码。别急着调 PhpStorm 设置，先在终端里让 phpunit --coverage-text 有输出再说。
