什么是单元测试覆盖率
关于其定义，先来看一下维基百科上的一段描述：
代码覆盖（Code coverage）是软件测试中的一种度量，描述程序中源代码被测试的比例和程度，所得比例称为代码覆盖率。
简单来理解，就是单元测试中代码执行量与代码总量之间的比率。
以一个最简单的例子来直观感受一下：
Service服务类：
public class NumToStringServiceImpl implements NumToStringService {
@Override
public String num2Str(Integer i) {
String str = "";
switch (i) {
case 1:
str = "one";
break;
case 2:
str = "two";
break;
default:
str = "none";
}
return str;
}
}
单元测试类：
public class NumToStringServiceTest {
@Autowired
NumToStringService numToStringService;
@Test
void testNum2Str() {
String str1 = numToStringService.num2Str(1);
assertThat(str1, is("one"));
String str2 = numToStringService.num2Str(2);
assertThat(str2, is("two"));
}
}
从上面的代码中能看出，单元测试方法testNum2Str能够覆盖到服务类num2Str方法的case 1和case 2两个分支，覆盖不到default分支。那么覆盖率就是num2Str方法case 1和case 2分支的代码量除以方法的总代码量。
单元测试覆盖率框架
单元测试覆盖率常用的框架有JaCoCo、EMMA和Cobertura。我们目前（在Jenkins中）使用的是JaCoCo。
JaCoCo可以统计的指标有：
- 指令（C0 Coverage）：JaCoCo计数的最小单元是单一的Java字节码指令。指令覆盖率提供了关于字节码执行数量、未执行数量的信息。
- 分支（C1 Coverage）：对所有的
if和switch语句计算分支覆盖率。统计在方法中分支执行数量、未执行数量的信息。但要注意，异常处理不在此计算范围内。 - 圈复杂度（Cyclomatic Complexity）：对非抽象方法计算圈复杂度，并汇总类、包和组的（圈）复杂度。这个值可以做为单元测试用例是否完全覆盖的参考。
- 行（Lines）：一行可能包含一条或多条指令，如果至少有一条指令被执行了，那么该行就算作是被执行了。
- 方法（Methods）：每个非抽象方法至少包含一条指令。如果至少有一条指令被执行了，那么该方法就算作是被执行了。
- 类（Classes）：如果类中至少有一个方法被执行了，那么该类就算作是被执行了。
注：个人认为，最需要关注的指标是行（Lines）和分支（C1 Coverage），其次是方法（Methods）和类（Classes），指令（C0 Coverage）和圈复杂度（Cyclomatic Complexity）可以不用关注，因为跟行（Lines）和分支（C1 Coverage）其实是差不多的，只不过多了一种参考维度。
查看单元测试覆盖率
在IntelliJ IDEA中已经内置了JaCoCo插件，因此研发可以在本机运行单元测试来查看覆盖率：
1、点击IDE右上侧的"Edit Configurations..."：
2、在"Choose coverage runner"中选择JaCoCo：
3、点击"Run ... with Coverage"运行：
4、运行完成后会展示分支（C1 Coverage）、行（Lines）、方法（Methods）、类（Classes）这四个指标：
5、点击"Generate Coverage Report"可以生成一份html版的所有指标的报告：
JaCoCo与持续集成
1、需要在项目的<plugins>中加入JaCoCo插件：
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>0.8.5</version>
<executions>
<execution>
<id>default-prepare-agent</id>
<goals>
<goal>prepare-agent</goal>
</goals>
</execution>
<execution>
<id>default-report</id>
<goals>
<goal>report</goal>
</goals>
</execution>
</executions>
</plugin>
目前发现如果项目中不加以上配置，而是在Jenkinsfile中
以命令的方式去应用JaCoCo，会导致不能生成jacoco.exec，进而无法运行覆盖率测试。
2、在Jenkinsfile中加入
exclusionPattern: '**/controller/*.class', sourceExclusionPattern: '**/controller/*.java'可以过滤掉controller层的检测。因为目前我们的单元测试主要是针对service层的，如果把controller层的类引入进来，会使单元测试覆盖率的值变低。
3、可以在Jenkins（http://${ip}:${port}/job/${your_project}/lastBuild/jacoco/）中查看生成的单元测试覆盖率报告：
该报告与IntelliJ IDEA中的报告都是JaCoCo原生的，是准确的。
目前发现SonarQube中的报告一是不准，二是指标不全，建议不要查看SonarQube的报告。
题外话
覆盖率作为衡量单元测试质量的唯一标准是不合理的。比如下面这个例子：
public double cal(double a, double b) {
if (b != 0) {
return a / b;
}
}
仅一个测试用例就可以做到100%的覆盖率，比如cal(10.0, 2.0)，但并不代表测试足够全面了，还需要考虑当除数等于0的情况下，代码执行是否符合预期。
---------------------
作者：谷隐凡二
来源：CSDN
原文：https://blog.csdn.net/m0_37570494/article/details/125440949
版权声明：本文为作者原创文章，转载请附上博文链接！
内容解析By：CSDN,CNBLOG博客文章一键转载插件
