编译JUnit测试用例时提示“JUnit not found”的原因排查

作为经常踩JUnit配置坑的老玩家，我帮你梳理几个最可能导致这个错误的原因，你可以对照自己的情况逐一排查：

1. 类路径（Classpath）未正确配置 #

编译Java测试类时，javac编译器需要明确知道JUnit库文件的位置。如果你的系统全局Classpath里没包含JUnit的jar包，编译器肯定会报“找不到JUnit”的错误。

• 排查步骤：

  • 先去~/java目录看看，有没有JUnit相关的jar包（比如JUnit 4需要junit.jar和hamcrest-core.jar，JUnit 5则是junit-jupiter-api.jar、junit-jupiter-engine.jar这类）。
  • 打开你的.bash_profile文件，检查有没有类似这样的配置行：

    export CLASSPATH=.:~/java/junit.jar:~/java/hamcrest-core.jar
    

    注意这里的.不能丢，它代表当前目录，否则编译器找不到你自己写的测试类。

• 解决方法：

  • 如果jar包缺失，下载对应版本的完整JUnit jar包（包括依赖）放到~/java目录。
  • 如果Classpath配置不对，修改.bash_profile后，在终端执行source ~/.bash_profile让配置立即生效。

2. 编译命令未显式指定类路径 #

有时候即使全局Classpath配置好了，也可能因为终端环境没加载新配置，或者你想临时测试，这时候需要在编译命令里手动指定类路径。

• 排查步骤：
  看看你是不是直接用了javac MyTest.java这种简单命令，没有加上-classpath（或缩写-cp）参数。

• 解决方法：
  编译时用完整的命令指定类路径（以JUnit 4为例）：

  javac -cp .:~/java/junit.jar:~/java/hamcrest-core.jar MyTest.java
  

  运行测试时也要指定类路径：

  java -cp .:~/java/junit.jar:~/java/hamcrest-core.jar org.junit.runner.JUnitCore MyTest
  

3. JUnit版本不匹配或jar包不完整 #

别小看依赖缺失的问题！比如JUnit 4必须搭配Hamcrest库才能正常工作，如果你只放了junit.jar没放hamcrest-core.jar，编译器可能会抛出类似“JUnit not found”的错误（本质是找不到依赖类）。

• 排查步骤：
  核对~/java里的jar包是否对应你使用的JUnit版本：

  • JUnit 4：至少要有junit-4.x.jar + hamcrest-core-1.x.jar
  • JUnit 5：需要junit-jupiter-api.jar + junit-jupiter-engine.jar + junit-platform-launcher.jar（运行测试用）

• 解决方法：
  下载对应版本的完整依赖包，替换掉不完整的jar文件。

4. 环境变量未正确加载 #

如果你刚修改完.bash_profile就去编译测试类，很可能新的Classpath配置还没生效，终端用的还是旧的环境变量。

• 排查步骤：
  在终端执行echo $CLASSPATH，看看输出里有没有包含你添加的JUnit jar路径。如果没有，说明配置没加载。

• 解决方法：
  执行source ~/.bash_profile重新加载配置，再用echo $CLASSPATH验证一遍。

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