Windows环境下PHPUnit结合PCOV代码覆盖率显示0%问题排查

针对你遇到的PHP 8.1.12、PHPUnit 9.5.0、PCOV 1.0.11组合下覆盖率始终为0%的问题，按以下步骤排查修复：

1. 确认PCOV扩展正确启用与配置 #

• 打开php.ini，检查是否存在以下配置（注意Windows路径格式）：

  extension=pcov.dll
  pcov.enabled=1
  pcov.directory="C:/path/to/your/project"  # 替换为你的项目根目录，用正斜杠或双反斜杠
  pcov.exclude="vendor/,tests/"  # 排除不需要统计的目录
  

• 验证扩展加载状态：在命令行执行

  php -r "var_dump(extension_loaded('pcov'));"
  

  需返回bool(true)，否则说明扩展未正确安装或配置。

2. 修正PHPUnit的覆盖率配置 #

• 编辑phpunit.xml，确保指定使用PCOV驱动，并正确配置源码目录：

  <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.5/phpunit.xsd"
           bootstrap="vendor/autoload.php"
           verbose="true">
    <!-- 禁用Xdebug避免冲突 -->
    <php>
      <ini name="xdebug.mode" value="off"/>
    </php>
    <!-- 覆盖率配置 -->
    <coverage processUncoveredFiles="true">
      <include>
        <directory suffix=".php">./src</directory> <!-- 替换为你的源码目录 -->
      </include>
      <exclude>
        <directory suffix=".php">./vendor</directory>
        <directory suffix=".php">./tests</directory>
      </exclude>
      <report>
        <html outputDirectory="./coverage"/>
      </report>
    </coverage>
    <!-- 其他测试配置... -->
  </phpunit>
  

• 关键注意：如果Xdebug同时加载，PHPUnit会优先使用Xdebug而非PCOV，需强制关闭Xdebug的覆盖率模式。

3. 解决Windows路径匹配问题 #

• PCOV的pcov.directory配置必须和PHPUnit识别的路径格式一致，避免使用单反斜杠（会被解析为转义字符），统一用正斜杠：
  错误示例：C:\projects\my-app
  正确示例：C:/projects/my-app 或 C:\\projects\\my-app
• 确认phpunit.xml中<include>的目录路径是相对项目根目录的正确路径，比如源码在项目根下的src文件夹，就写./src。

4. 验证测试执行与覆盖率命令 #

• 确保使用正确的PHPUnit命令执行测试并生成覆盖率：
  Windows命令行：

  vendor\bin\phpunit --coverage-html ./coverage
  

• 检查测试输出日志，确认测试方法确实被执行（无Skipped或Incomplete标记），且目标函数的代码分支都被触发。

5. 兼容性验证 #

• PCOV 1.0.11与PHP 8.1.x、PHPUnit 9.5.x是兼容的，但如果以上步骤都无效，可以尝试更新PCOV到最新稳定版（当前支持PHP8.1的最新版是1.0.12），重新安装扩展后再测试。

内容的提问来源于stack exchange，提问作者george