如何在IntelliJ IDEA中手动添加测试文件夹并编写JUnit测试用例？

一、添加测试文件夹结构 #

• 遵循Java项目标准结构，在项目根目录下创建src/test/java文件夹（与src/main/java对应）
• 按照源码的包结构，在src/test/java下创建完全一致的包路径，比如源码在com.example.service，测试代码就放在src/test/java/com/example/service下，保证测试类和被测试类的包结构对应，方便引用
• 如果是非构建工具管理的普通项目，也可直接在项目根目录创建test文件夹，内部按包结构存放测试类

二、引入JUnit依赖 #

Maven项目 #

在pom.xml的<dependencies>节点中添加以下依赖：

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

Gradle项目 #

在build.gradle的依赖块中添加：

testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.2'
testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.2'

普通Java项目 #

手动下载JUnit 5的核心jar包（junit-jupiter-api-x.x.x.jar和junit-jupiter-engine-x.x.x.jar），将它们添加到项目的类路径中（IDE中可通过"Project Structure"或"Build Path"设置）

三、编写JUnit测试用例 #

• 在测试文件夹的对应包下创建测试类，命名规则一般为被测试类名+Test，比如被测试类是Calculator，测试类就叫CalculatorTest
• 示例测试代码：

package com.example.service;

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

public class CalculatorTest {

    // 测试加法功能
    @Test
    void testAdd() {
        Calculator calculator = new Calculator();
        int actualResult = calculator.add(3, 5);
        // 断言结果符合预期
        assertEquals(8, actualResult, "3加5的结果应为8");
    }

    // 测试减法功能
    @Test
    void testSubtract() {
        Calculator calculator = new Calculator();
        int actualResult = calculator.subtract(10, 4);
        assertEquals(6, actualResult);
    }
}

• 注意：JUnit 5使用org.junit.jupiter.api.Test注解标记测试方法，静态导入Assertions类的断言方法可以让代码更简洁

四、执行测试并查看结果 #

IDE中执行 #

• 在IntelliJ IDEA或Eclipse中，右键点击测试类/测试方法，选择"Run '测试类名'"或"Run '测试方法名'"
• 执行完成后，IDE的运行窗口会展示测试结果：通过的测试用例会标绿色，失败的标红色，失败时会显示具体的断言错误信息，方便排查问题

命令行执行（Maven） #

在项目根目录执行命令：

mvn test

控制台会输出所有测试的执行情况，包括通过数、失败数、跳过数，以及失败的详细原因

命令行执行（Gradle） #

在项目根目录执行命令：

gradle test

控制台会输出测试结果，同时还可以在项目的build/reports/tests/test目录下找到HTML格式的测试报告，打开后能看到更直观的测试统计和详情

内容的提问来源于stack exchange，提问作者Arun