在小公司里代码覆盖率常被当成“可有可无”的指标，导致大家盲目写测试却不知道到底覆盖了哪些代码。覆盖率是衡量测试充分性的关键参考：虽然它不能直接证明代码质量高，但覆盖率低几乎等同于“潜在缺陷未被发现”。老实说，

最近我尝试了一个业界主流的覆盖率框架——JaCoCo并把实际经验整理成一篇完整的教程。帮助你摆脱“乱测、看不见”的尴尬。说起来，

简介

JaCoCo是一款开源的 Java 代码覆盖率工具。采用字节码插桩技术收集执行数据，并生成直观的报告。老实说，它已经成为 Java 环境中的标准

• 支持 Maven、Gradle、Ant 等主流建立工具；
• 可以通过 Java Agent 实时监控运行中的 JVM 程序；
• 提供丰富的 HTML、XML、CSV 报告，帮助快速定位未被测试的代码方法。

从官方站点来看。GitHub：

实战案例

Maven 依赖配置

org.jacoco
jacoco-maven-plugin
${jacoco.version}


prepare-agent

prepare-agent



report
test

report

关键插件阶段：

• prepare-agent在 process-test-classes 阶段自动启动 JaCoCo Agent，对字节码进行插桩，以便收集运行时数据。话说回来，
• report在 test 阶段之后读取 jacoco.exec 文件并生成 HTML 报告。

业务用例

控制层示例：

/**
* 计算器 REST 控制器 - 用于演示 JaCoCo 集成测试覆盖率
*/
@RestController
@RequestMapping
@RequiredArgsConstructor
public class CalculatorController {
private final CalculatorService calculatorService;按理说，/** 加法 */
@GetMapping
public Map add {
int result = calculatorService.add;其实，return Map.of;}
/** 减法 */
@GetMapping
public Map subtract {
int result = calculatorService.subtract;return Map.of;说起来，}
/** 除法 */
@GetMapping
public Map divide {
double result = calculatorService.divide;return Map.of;}
/** 全局异常处理 - 捕获 IllegalArgumentException */
@ExceptionHandler
public Map handleIllegalArgument {
return Map.of);}
}

服务层示例：

/**
* 计算器服务 - 用于演示 JaCoCo 代码覆盖率
*/
@Service
public class CalculatorService {
/** 加法 */
public int add {
return a + b;}
/** 减法 */
public int subtract {
return a - b;}
/** 除法 */
public double divide {
if {
throw new IllegalArgumentException;
不过，}
return a / b;}
}

测试用例

痛点提示：很多团队只写“成功方法”测试，导致分支、异常等关键方法永远是红色。下面的示例通过 @Nested/@DisplayName 把不同场景拆分，让每一条业务方法都能被直观看到。

@SpringBootTest
@AutoConfigureMockMvc
@DisplayName
class CalculatorIntegrationTest {
@Autowired
private MockMvc mockMvc;// ===================== 基本运算 API =====================
@Nested
@DisplayName
class BasicApi {
@Test
@DisplayName
void testAdd throws Exception {
mockMvc.perform
.param
.param)
.andExpect.isOk)
.andExpect.value)
.andExpect.value);}
@Test
@DisplayName
void testSubtract throws Exception {
mockMvc.perform
.param
.param)
.andExpect.isOk)
.andExpect.value)
.andExpect.value);}
@Test
@DisplayName")
void testDivide throws Exception {
mockMvc.perform
.param
.param)
.andExpect.isOk)
.andExpect.value)
.andExpect.value);}
}
// ===================== 异常处理 =====================
@Nested
@DisplayName
class ExceptionHandler {
@Test
@DisplayName
void testDivideByZeroTriggersExceptionHandler throws Exception {
mockMvc.perform
.param
.param)
.andExpect.isOk)
.andExpect.value)
.andExpect.value);}
}
}

编译与执行

mvn clean test
# 执行完毕后target/site/jacoco/index.html 即为可视化报告入口

覆盖率报告解读技巧 🚀

Pain Point 对应措施：

• #1 “我只想看整体百分比”，结果发现关键方法全红？怎么说呢，- 打开报告后先筛选"Missed Methods"。把红色的方法列出来逐个补充单元/集成测试。
• #2 “分支太多，我不想手动点”。- 使用报告左侧的"Package → Class → Method""Tree"，一次性展开所有黄色/红色节点。
• #3 “异常捕获从来不跑”。- 在报告中专门关注Cxty 高且 Missed Branches 较多的类，这往往是缺失异常方法的信号。
• #4 “CI 上报错但本地看不出问题”。- 将 ${project.build.directory}/site/jacoco/jacoco.xml) 上传至 CI 的 Codecov 或 SonarQube，可直接对比历史趋势。
\endul}

关键指标速览的观点是。 <\/tr>Cxty <\/ t d>方法内部复杂度 \/值越高风险越大 \/≤15 为佳 \/<\/ tr>

指标名称	含义	关注点	建议阈值
Missed Instructions / Total <\/ td>	未覆盖指令数 / 总指令数 <\/ td>	整体执行细粒度 <\/ td>	80%+ 覆盖率 <\/ td>
Missed Branches / Total <\/ td>	未覆盖分支数 / 总分支数 <\/ td>	条件/循环完整性 <\/ td>	70%+ 分支覆盖 <\/ td>

"别再随意写几个单元测了" — 没有真实可视化的数据，你根本不知道自己的代码到底漏掉了哪些风险点！使用 JaCoCo，你可以把“盲区”变成“一目了然”的红绿灯。从而有针对性地补齐测试，

• 如果你的团队还没有明确的,那么现在就设一个基准线吧；
• 在 CI 中加入 /jacoco/report.xml<\/c od e>/ 或者上传至 Codecov，让每次 PR 都自动检查；
• 记得把“异常分支”“catch 块”单独列出来这些往往是导致生产 bug 的隐藏杀手。<\/ul>
  

P.S. 🚀 *你们公司要求多少的代码覆 盖率才算达标？快在评论区聊聊，*