PhpStorm本身不生成覆盖率数据，仅可视化Xdebug或PCOV收集的结果；若“Run with Coverage”无报告、全灰或0%，问题几乎必在PHP CLI环境（Xdebug/PCOV未启用）、PHPUnit未实际执行测试，或路径映射不一致。

PhpStorm 本身不生成覆盖率数据，它只负责把 Xdebug 或 PCOV 收集到的行执行标记可视化。如果你点了 “Run with Coverage” 却看不到报告、全是灰色或 0%，问题 99% 出在 PHP CLI 环境或 PHPUnit 配置上，不是 PhpStorm 设置错了。

确认 CLI 下 Xdebug 或 PCOV 真的在工作

PhpStorm 调用的是你配置的 PHP CLI 解释器，不是 Apache/Nginx/FPM 的 PHP。很多用户 Web 端能跑 Xdebug，但 php -m 根本不显示 xdebug 或 pcov。

• 在终端运行 php -v，确认是你要用的 PHP 版本（比如 8.2）
• 运行 php -m | grep -E "(xdebug|pcov)"，必须有输出；为空就说明没加载
• 运行 php --ini 查看 CLI 加载的 php.ini 路径，编辑那个文件：
  • Xdebug 3：加 xdebug.mode=coverage（不是 xdebug.coverage_enable=1）
  • PCOV：加 extension=pcov.so、pcov.enabled=1、pcov.directory="."
• 改完重启终端（或 source ~/.zshrc），再验证一次 php -m

确保 PHPUnit 实际执行了你的测试

覆盖率面板空白、控制台只输出 Time: 00:00.000, Memory: 2.00 MB，大概率是 PHPUnit 根本没跑任何测试用例——不是没覆盖，是压根没执行。

• 检查测试类命名是否合规：UserTest 类必须放在 UserTest.php 文件里，且继承 TestCase
• 确认项目根目录存在 phpunit.xml 或 phpunit.xml.dist，且 <directory> 指向正确的测试路径（如 tests/）
• 在终端手动运行 ./vendor/bin/phpunit --coverage-text：
  • 如果报错、或输出 0 tests，问题不在 PhpStorm，在 autoloading 或配置
  • 如果正常输出覆盖率数字，说明环境 OK，回头再查 PhpStorm 的 Run Configuration
• PhpStorm 的 Run Configuration 中，“Test runner” 必须设为 PHPUnit，Path to phpunit.phar 或 Autoload script 要指向真实可执行文件（比如 vendor/bin/phpunit）

解决“文件全灰”或“0% 但其实测了”的路径映射问题

灰色 ≠ 没测，是 PhpStorm 找不到源码路径和覆盖率数据中记录的路径之间的对应关系。尤其在 Docker、Vagrant、自定义 autoload 或跨平台开发时高频发生。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

立即学习“PHP免费学习笔记（深入）”；

• --coverage-clover 输出的 XML 里路径是绝对路径；如果你在容器里跑测试，XML 里的路径可能是 /var/www/src/，但本地项目在 /Users/me/project/src/
• 进 PhpStorm 设置 → Build, Execution, Deployment → Coverage → 点击右下角 Configure paths mapping...：
  • 左侧填覆盖率数据里的路径（如 /var/www/src/）
  • 右侧填你本地项目对应路径（如 $PROJECT_DIR$/src/）
• 如果用 PCOV，pcov.directory="." 必须指向项目根目录（即 phpunit.xml 所在位置），否则路径解析会错位
• PHPStorm 的覆盖率工具窗口里，右键某个灰色文件 → Copy Absolute Path，对比它和你本地文件实际路径，就能快速定位映射偏差点

别忽略 phpunit.xml 里的 coverage 配置细节

即使 CLI 和 PhpStorm 都配对了，phpunit.xml 里 coverage 部分写错，也会导致报告空或范围错误。

• <include> 定义的是“要统计哪些源码”，不是“哪些测试要跑”。漏掉 src/ 就等于没统计任何业务代码
• 务必加 processUncoveredFiles="true"，否则未被任何测试执行的文件直接从报告里消失（你以为覆盖率高，其实是被过滤掉了）
• <exclude> 要显式排除测试辅助类（如 src/Tests/Helper.php），否则它们会被计入“被测代码”，拉低整体数值
• 路径都是相对于 phpunit.xml 所在目录的，不是项目根目录，也不是 src/ 目录

最常被忽略的点：路径映射失败时，你看到的“0%”不是真的没执行，而是 PhpStorm 根本找不到对应文件；而 processUncoveredFiles="true" 缺失时，那些真正裸奔的代码反而不会出现在报告里——这两者叠加，会让覆盖率数字严重失真，但表面看起来却很“干净”。