PHPUnit覆盖率排除指定文件配置未生效，如何解决？

1. 修正排除规则的匹配目标 #

你当前配置的suffix="Resource.php"会匹配所有以Resource.php结尾的文件，但实际需要排除的是**EndpointResource.php**后缀的文件，先调整匹配规则：

<coverage cacheDirectory="var/phpunit/coverage/.phpunit.cache">
  <exclude>
    <!-- 精准匹配所有以EndpointResource.php结尾的文件 -->
    <directory suffix="EndpointResource.php">src/App/Ui/</directory>
  </exclude>
  <!-- 保留原报告配置 -->
  <report>
    <clover outputFile="var/phpunit/coverage/clover.xml"/>
    <crap4j outputFile="var/phpunit/coverage/crap4j.xml"/>
    <html outputDirectory="var/phpunit/coverage"/>
    <xml outputDirectory="var/phpunit/coverage"/>
    <text outputFile="php://stdout" showUncoveredFiles="true"/>
  </report>
</coverage>

2. 清理覆盖率缓存 #

你配置了cacheDirectory，旧缓存会导致新的排除规则不生效，直接删除缓存目录：

rm -rf var/phpunit/coverage/.phpunit.cache

清理后重新运行测试生成覆盖率报告。

3. 验证路径正确性 #

确保src/App/Ui/是相对于phpunit.xml的正确路径：

• 若phpunit.xml在项目根目录，src/App/Ui/路径无误（可尝试去掉前缀./）
• 可临时替换为绝对路径测试，比如/your-project-root/src/App/Ui/，确认路径指向目标目录

4. 检查节点冲突 #

如果phpunit.xml中存在<include>节点，需确保<exclude>节点在<include>之后（PHPUnit先执行include规则，再执行exclude规则）：

<coverage cacheDirectory="var/phpunit/coverage/.phpunit.cache">
  <include>
    <directory>src/</directory>
  </include>
  <exclude>
    <directory suffix="EndpointResource.php">src/App/Ui/</directory>
  </exclude>
  <!-- 报告配置 -->
</coverage>

5. 备选：直接用通配符匹配文件 #

若directory规则仍不生效，可尝试用<file>节点结合递归通配符：

<exclude>
  <file>src/App/Ui/**/*EndpointResource.php</file>
</exclude>

注：部分PHPUnit版本支持**递归匹配子目录，若不支持可分目录单独指定。

验证排除效果 #

运行测试后，查看文本报告的Uncovered Files部分，确认EndpointResource.php文件是否已从列表中移除，同时检查覆盖率统计的文件总数是否减少。

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