使用JUnit时Java测试类无法找到，类不在项目类路径中

问题概述 #

测试类playerTests.java无法被IDE识别为JUnit测试文件，同时收到警告：该文件不在项目类路径中，无法编译为.class文件。测试代码如下：

import org.junit.Test;
import static org.junit.Assert.assertEquals;
import java.io.FileWriter;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.ArrayList;

public class playerTests {

    @Test
    public void testListPlayersByPortalsConquered() {
        
        Player player1 = new Player("Player 1", "Team A", 80, 100, 5);
        Player player2 = new Player("Player 2", "Team B", 90, 100, 3);
        Player player3 = new Player("Player 3", "Team C", 70, 100, 7);
        Player player4 = new Player("Player 4", "Team A", 100, 100, 4);
        Player player5 = new Player("Player 5", "Team B", 60, 100, 2);
        
        player1.setPortalsConquered(10);
        player2.setPortalsConquered(8);
        player3.setPortalsConquered(15);
        player4.setPortalsConquered(12);
        player5.setPortalsConquered(5);
        
        ArrayList<Player> players = new ArrayList<>();
        players.add(player1);
        players.add(player2);
        players.add(player3);
        players.add(player4);
        players.add(player5);
        
        PlayerLoader playerLoader = new PlayerLoader();
        playerLoader.players = players;
        playerLoader.listPlayersByPortalsConquered();
        
        String expectedOutput = "               ----------------------------------\n"
                + "               | \033[1m\033[31mPlayers ordered by portals\033[0m     |\n"
                + "               ----------------------------------\n"
                + "               ----------------------------------\n"
                + "               | Player: Player 3\n"
                + "               | Portals Conquered: 15\n"
                + "               ----------------------------------\n"
                + "               ----------------------------------\n"
                + "               | Player: Player 4\n"
                + "               | Portals Conquered: 12\n"
                + "               ----------------------------------\n"
                + "               ----------------------------------\n"
                + "               | Player: Player 1\n"
                + "               | Portals Conquered: 10\n"
                + "               ----------------------------------\n"
                + "               ----------------------------------\n"
                + "               | Player: Player 2\n"
                + "               | Portals Conquered: 8\n"
                + "               ----------------------------------\n"
                + "               ----------------------------------\n"
                + "               | Player: Player 5\n"
                + "               | Portals Conquered: 5\n"
                + "               ----------------------------------\n";

        String tempFile = "temp.txt";
        try {
            FileWriter fw = new FileWriter(tempFile);
            playerLoader.listPlayersByPortalsConquered();
            fw.close();
        } catch (Exception e) {
            e.printStackTrace();
        }

        try {
            String output = new String(Files.readAllBytes(Paths.get(tempFile)));
            assertEquals(expectedOutput, output);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

（注：测试类存放在项目根目录的test文件夹，但该目录未被标记为测试源目录；IDE中测试文件无JUnit标识，无法触发测试运行）

解决步骤 #

1. 标记测试目录为测试源根 #

IDE需要明确识别测试文件所在目录为测试资源目录，才能将其加入类路径：

• IntelliJ IDEA：右键点击test文件夹 → Mark Directory as → Test Sources Root（目录会变为绿色）
• Eclipse：右键点击test文件夹 → Build Path → Use as Source Folder

2. 补全JUnit注解与依赖 #

• 测试类必须导入JUnit核心类：

  import org.junit.Test;
  import static org.junit.Assert.assertEquals;
  

• 若使用构建工具，确保添加JUnit依赖：
  • Maven（pom.xml）：

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

  • Gradle（build.gradle）：

    testImplementation 'junit:junit:4.13.2'
    

• 未使用构建工具时，手动将JUnit的.jar文件添加到项目的测试类路径。

3. 修复测试代码的输出逻辑 #

原代码中调用playerLoader.listPlayersByPortalsConquered()并未将输出写入文件，需重定向控制台输出到临时文件：

String tempFile = "temp.txt";
PrintStream originalOut = System.out;
try (FileOutputStream fos = new FileOutputStream(tempFile);
     PrintStream ps = new PrintStream(fos)) {
    System.setOut(ps);
    playerLoader.listPlayersByPortalsConquered(); // 输出写入文件
} catch (Exception e) {
    e.printStackTrace();
} finally {
    System.setOut(originalOut); // 恢复控制台输出
}

// 读取文件并断言
try {
    String output = new String(Files.readAllBytes(Paths.get(tempFile)));
    assertEquals(expectedOutput, output);
    Files.deleteIfExists(Paths.get(tempFile)); // 清理临时文件
} catch (Exception e) {
    e.printStackTrace();
}

4. 遵循JUnit命名规范（可选） #

虽然不是强制要求，但JUnit默认更易识别以Test结尾的类名（如PlayerTest），调整类名可提升IDE识别效率。

内容的提问来源于stack exchange，提问作者João Vieira