JaCoCo是Java项目最常用单元测试覆盖率工具，核心三步为插桩→运行测试→生成报告；通过Maven插件配置prepare-agent自动注入探针、绑定report至verify阶段，执行mvn clean verify即可生成含行/分支/方法等多维指标的HTML报告。
JaCoCo 是 Java 项目中最常用、最成熟的单元测试覆盖率统计工具，它不侵入源码，支持 Maven/Gradle 集成，能生成直观的 HTML 报告，覆盖指令、行、分支、方法、类等多个维度。用它统计单测覆盖率，核心就三步：插桩 → 运行测试 → 生成报告。
在 Maven 项目中快速接入
只需在 pom.xml 的 <build><plugins></plugins></build> 中添加 JaCoCo 插件配置：
- 使用
prepare-agent在测试启动前自动注入探针（即插桩），无需改代码 - 绑定
report到verify或package阶段，确保测试执行后立即生成报告 - 推荐配置示例（适配主流 JDK 和 JUnit 5）：
执行命令生成覆盖率报告
终端进入项目根目录后，运行：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
mvn clean test—— 先确保测试能通过（JaCoCo 默认会在 test 阶段插桩） -
mvn jacoco:report—— 单独生成报告（输出路径默认为target/site/jacoco/） - 或一步到位：
mvn clean verify（含 test + report） - 打开
target/site/jacoco/index.html，即可查看带颜色标记的交互式报告：绿色=全覆盖，黄色=分支部分覆盖，红色=未执行
常见问题与关键细节
实际使用中容易卡在这几个点：
立即学习“Java免费学习笔记（深入）”；
-
测试没跑？ 检查是否遗漏
maven-surefire-plugin配置，或@Test注解用错（JUnit 4 用org.junit.Test，JUnit 5 用org.junit.jupiter.api.Test） -
报告为空或 0%？ 多半是插桩失败——确认
prepare-agent执行成功（控制台应有[INFO] argLine set to ...），且测试类名匹配默认规则（如*Test.java、*Tests.java、）</li> <li><strong>想排除某些类（如 Lombok、DTO）？</strong> 在插件 <code><configuration>
中加<excludes><exclude>**/dto/**</exclude></excludes> -
Gradle 用户：只需在
build.gradle加apply plugin: 'jacoco'，再配置jacoco { toolVersion = '0.8.12' }即可，报告默认在build/reports/jacoco/test/
不只是看百分比：怎么用才有效
覆盖率数字本身不是目标，而是定位盲区的线索：
- 优先关注 行覆盖率低但逻辑关键的类（如 service、controller），而不是工具类或枚举
- 点击报告中的具体类，查看哪几行标红——往往对应 if/else、try/catch、switch 的未覆盖分支
- 对空构造、getter/setter 等样板代码，不必强求 100%，重点保障业务逻辑路径
- 配合 CI（如 Jenkins）设置阈值（如
mvn verify -Djacoco.check.instructionRatio=0.7），低于 70% 就构建失败
