PhpStorm本身不生成覆盖率数据，仅可视化Xdebug或PCOV收集的结果；若“Run with Coverage”无报告，需优先确认CLI下Xdebug/PCOV已启用、PHPUnit实际执行了测试、且源码路径与覆盖率数据路径映射一致。
PhpStorm 本身不生成覆盖率数据，它只是把 Xdebug 或 PCOV 收集的结果可视化。如果你点了 “Run with Coverage” 却没看到任何报告，问题几乎一定出在 PHP 环境或 PHPUnit 配置上，而不是 PhpStorm 设置错了。
确认 Xdebug 或 PCOV 是否真在 CLI 下启用
PhpStorm 调用的是你配置的 PHP CLI 解释器，不是 Web Server 的 PHP。很多用户配好了 Apache/FPM 的 Xdebug，却忘了 CLI 版本根本没加载扩展。
- 在终端执行
php -v，确认版本号（Xdebug 3 要求xdebug.mode=coverage，不是旧版的xdebug.coverage_enable=1） - 运行
php -m | grep -E "(xdebug|pcov)"，必须看到输出；如果为空，说明 CLI 没加载 - 用
php --ini查看 CLI 加载的 php.ini 路径，编辑对应文件：Xdebug 3 加xdebug.mode=coverage，PCOV 加pcov.enabled=1和pcov.directory="." - 重启终端或重载 shell 配置（如
source ~/.zshrc），再验证
PHPUnit 是否真的执行了测试
覆盖率面板空白、控制台只显示 Time: 00:00.000, Memory: 2.00 MB，大概率是 PHPUnit 根本没跑任何测试用例。
- 检查测试类命名是否合规：
UserTest类必须放在UserTest.php文件里，且继承TestCase - 确认项目根目录存在
phpunit.xml或phpunit.xml.dist，且<directory></directory>指向正确的测试路径（如tests/） - 在终端手动执行
./vendor/bin/phpunit --coverage-text，如果报错或输出为 0 tests，说明问题不在 PhpStorm，在 autoloading 或配置 - PhpStorm 的 Run Configuration 中，Test runner 必须设为 PHPUnit，Path to phpunit.phar 或 Autoload script 要指向真实可执行文件（比如
vendor/bin/phpunit）
覆盖率路径映射失败导致大量文件灰色或 0%
灰色 ≠ 没测，是 PhpStorm 找不到源码路径和覆盖率数据中记录的路径之间的对应关系。Docker、Vagrant、自定义 autoload 或跨平台开发时高频发生。
立即学习“PHP免费学习笔记（深入）”；
- 用
phpunit --coverage-clover coverage.xml生成 XML 后，打开看<file name="/var/www/src/User.php"></file>—— 这个绝对路径必须和你本地项目路径一致，否则 PhpStorm 匹配不上 - 若在容器内运行，需在 phpunit.xml 中配置
<coverage processuncoveredfiles="true"></coverage>，并用--whitelist ./src/显式限定范围 - PhpStorm 的 Coverage 配置页中，“Include paths” 建议填相对路径（如
src/），避免硬写/Users/xxx/project/src - 修改过路径后，删掉
.idea/coverage/目录再重试，旧缓存常导致映射残留
查看与导出报告的关键操作点
覆盖率标记只在“成功采集到数据”后才出现。绿色/红色/黄色条出现在编辑器左侧装订线，但前提是 PHPUnit 真的执行了、扩展真的收集了、路径真的对上了。
- 右键测试文件 → Run 'UserTest' with Coverage，不是普通 Run
- 测试完成后，按
Alt+6（Windows/Linux）或Cmd+6（macOS）呼出 Coverage 工具窗口，这里能看到文件级覆盖率和分支率（branch-rate） - 想导出 HTML 报告：在终端运行
./vendor/bin/phpunit --coverage-html coverage/ --whitelist src/，然后用浏览器打开coverage/index.html - 分支未覆盖（黄色行）不代表 bug，但意味着某个 if/else 或 match 分支没被触发，要结合测试用例补全逻辑路径
最常被忽略的是：PHP CLI 环境和 PhpStorm 解释器指向的不是同一个 PHP 实例，或者 phpunit.xml 里漏写了 <testsuites></testsuites> 结构。这两点不解决，其他所有设置都是白搭。
