类覆盖率（class coverage）衡量的是项目中被测试代码覆盖的类占总类的比例，具体做法是统计所有已编译的 `.class` 文件，计算其中至少有一条字节码指令被执行过的类数量与总类数量的比值。
哪些类会被计入覆盖率分母
在 Java 单元测试中，分母通常包含项目源码中的所有类、第三方依赖库中的类以及生成的字节码。默认情况下，Jacoco 等工具会扫描 classpath 下的所有类文件，这意味着即使你没有为某个类编写测试用例，它也会被计入总数，从而拉低整体的覆盖率数值。
import org.jacoco.agent.rt.AgentBuilder;
import java.lang.instrument.Instrumentation;
public class CoverageConfig {
public static void main(String[] args) throws Exception {
// 模拟启动时加载 Jacoco Agent
Instrumentation inst = null;
System.out.println("Coverage analysis started");
}
}
上述配置展示了如何初始化覆盖率采集环境。当程序运行时，Instrumentation 接口会拦截类的加载过程。如果某个类（如 CoverageConfig）没有任何方法被调用，它的字节码指令执行计数将保持为零。在生成报告时，该类的状态会被标记为未覆盖。开发者可以通过配置排除规则，将这些不需要测试的类从分母中移除，以获得更准确的业务逻辑覆盖率指标。
立即学习“Java免费学习笔记（深入）”；
类覆盖率与行覆盖率的区别
类覆盖率是一个粗粒度的指标，它只关心类是否“活过”，而不关心类内部的具体执行情况。相比之下，行覆盖率（Line Coverage）或分支覆盖率（Branch Coverage）则深入到类的方法体内部，检查每一行代码或每一个条件判断是否被执行。如果一个类的所有方法都是空的，或者只包含简单的 getter/setter，类覆盖率可能显示为 100%，但行覆盖率可能因为缺乏具体的业务逻辑测试而较低。
public class SimpleService {
private String name;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
以 SimpleService 为例，该类只有两个简单的方法。如果单元测试中调用了 setName 和 getName，那么该类的类覆盖率就是 100%。然而，如果测试用例没有考虑到 name 为 null 的情况，虽然类覆盖率达标，但潜在的逻辑缺陷可能未被发现。因此，类覆盖率适合作为宏观监控指标，用于快速识别哪些模块完全没有经过测试，但在排查具体 bug 时，需要结合更细粒度的行或分支覆盖率数据。
如何处理未覆盖的类
当发现某些类未被覆盖时，首先需要判断这些类是否属于核心业务逻辑。对于工具类、配置类或仅包含静态方法的辅助类，如果它们不涉及复杂的业务状态变更，可以将其从覆盖率报告中排除。这通常通过在 jacoco.xml 或构建脚本中添加 excludes 规则来实现。例如，可以指定排除所有以 DTO 或 Entity 结尾的类，因为这些类通常只是数据的载体，不包含可执行的逻辑。
<jacoco>
<excludes>
<exclude>**/dto/*</exclude>
<exclude>**/entity/*</exclude>
</excludes>
</jacoco>
通过上述配置，构建工具在生成覆盖率报告时会忽略指定的包路径。这样，分母中的类数量减少，剩余类的覆盖率数值会更真实地反映核心代码的测试质量。此外，对于确实需要测试但未覆盖的类，应补充相应的单元测试，确保其关键路径得到验证。定期审查未覆盖列表，有助于持续改进测试套件的有效性。
