如何使用IDEA进行单元测试

在 IntelliJ IDEA 中进行单元测试的完整流程

一 环境准备与依赖配置

• 选择测试框架：常用为 JUnit（推荐 JUnit 5）或 TestNG。
• 使用构建工具添加依赖：
  • Maven（JUnit 5 常用组合）

    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-api</artifactId>
      <version>5.8.2</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-engine</artifactId>
      <version>5.8.2</version>
      <scope>test</scope>
    </dependency>
    

  • Gradle（JUnit 5）

    testImplementation 'org.junit.jupiter:junit-jupiter:5.8.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.2'
    

  • 如需使用 JUnit 4（示例）：
    • Maven

      <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
      </dependency>
      

    • Gradle

      testImplementation 'junit:junit:4.13.2'
      

• 确认依赖生效：在 File → Project Structure → Modules → Dependencies 检查测试依赖是否正确引入。

二 创建测试类与编写测试方法

• 生成测试类：在目标类上右键选择 Go To → Test → Create New Test，或按 Ctrl+Shift+T（Windows/Linux）/ Cmd+Shift+T（Mac）；选择 JUnit 5 作为框架，IDEA 会在 src/test/java 生成测试类，命名通常为 被测试类名 + Test（如 CalculatorTest）。
• 基本测试示例（JUnit 5）

  import org.junit.jupiter.api.Test;
  import static org.junit.jupiter.api.Assertions.*;
  
  class CalculatorTest {
      private final Calculator calculator = new Calculator();
  
      @Test
      void add_shouldReturnSum() {
          assertEquals(5, calculator.add(2, 3));
      }
  
      @Test
      void divide_shouldThrowWhenDivideByZero() {
          assertThrows(IllegalArgumentException.class, () -> calculator.divide(1, 0));
      }
  }
  

• 常用注解与断言：@Test、@BeforeEach/@AfterEach、@BeforeAll/@AfterAll；断言如 assertEquals、assertTrue、assertThrows。

三 运行与调试测试

• 运行与调试：在测试类或方法左侧点击绿色箭头选择 Run/Debug；或使用快捷键 Ctrl+Shift+F10（Windows/Linux）/ Control+Shift+R（Mac）。
• 测试结果：底部 Run 窗口显示通过（绿色）与失败（红色），点击失败项可查看堆栈与期望值/实际值对比。
• 覆盖率：选择 Run with Coverage 生成覆盖率报告，直观查看被测试代码行的覆盖情况。

四 进阶用法

• 参数化测试（JUnit 5）：减少重复用例，覆盖多组数据

  import org.junit.jupiter.params.ParameterizedTest;
  import org.junit.jupiter.params.provider.ValueSource;
  
  class CalculatorTest {
      private final Calculator calculator = new Calculator();
  
      @ParameterizedTest
      @ValueSource(ints = {1, 2, 3})
      void add_shouldReturnInputPlusOne(int n) {
          assertEquals(n + 1, calculator.add(n, 1));
      }
  }
  

• Mock 外部依赖：使用 Mockito 隔离被测对象

  import static org.mockito.Mockito.*;
  import static org.junit.jupiter.api.Assertions.*;
  
  class UserServiceTest {
      @Test
      void shouldReturnUserWhenFound() {
          var repo = mock(UserRepository.class);
          when(repo.findById(1L)).thenReturn(new User(1L, "Alice"));
  
          UserService service = new UserService(repo);
          var user = service.findById(1L);
  
          assertEquals("Alice", user.getName());
      }
  }
  

  依赖示例（Maven，JUnit 4 + Mockito 3）：

  <dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-core</artifactId>
    <version>3.11.2</version>
    <scope>test</scope>
  </dependency>
  

• 持续集成：将测试集成到 Jenkins/GitHub Actions/GitLab CI，每次提交自动运行测试并生成报告，保障质量门禁。

五 常见问题与排查

• @Test 无法导入：检查是否引入了正确的 JUnit 依赖（JUnit 5 为 org.junit.jupiter.api.Test），必要时重新导入 Maven/Gradle 项目。
• 测试方法无法运行：确保方法为 public（JUnit 4） 或 包可见/非 private（JUnit 5），且无参数；类应位于 src/test/java。
• 依赖未生效：在 Project Structure → Modules → Dependencies 确认测试依赖范围与版本；刷新构建工具项目。