intellij 中 maven 项目无法识别 junit 5 导入，通常源于测试源目录未被正确标记、依赖未生效或 ide 缓存未更新；本文提供从配置修正、目录标记到强制刷新的系统化解决步骤。
在 IntelliJ IDEA 中，即使 pom.xml 已正确声明 JUnit 5（如 junit-jupiter 和 junit-jupiter-engine），仍可能出现 @Test、Assertions 等类无法导入、红色波浪线提示“Cannot resolve symbol”等问题。这并非依赖本身错误，而是 IDE 未能将测试依赖与测试源码路径正确关联所致。
✅ 正确配置要点
-
确保测试目录被标记为 Test Sources Root
如图中所示，src/test/java 及其子包（如 uniTesting）必须被 IntelliJ 识别为测试源根目录：- 右键点击 src/test/java → Mark Directory as → Test Sources Root（若已标记，可先取消再重设）；
- 同理检查 src/test/resources 是否标记为 Test Resources Root。
精简并修正 pom.xml 依赖
junit-jupiter-engine 不需单独声明——它已被 junit-jupiter 传递依赖包含。冗余声明可能引发版本冲突或 IDE 解析异常。推荐使用以下最小化配置：
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>5.9.2</version>
<scope>test</scope> <!-- 关键：显式指定 scope -->
</dependency>⚠️ 注意：test 不仅语义准确（JUnit 仅用于测试），还能避免污染主编译路径，并帮助 IntelliJ 更精准地加载依赖作用域。
-
强制刷新 Maven 项目
-
清除 IDE 缓存（关键兜底操作）
- 菜单栏：File → Invalidate Caches and Restart… → 选择 Invalidate and Restart；
- 此操作可清除因索引损坏导致的“已添加却不可见”类问题——这也是用户反馈中“新建测试文件后自动修复”的根本原因：新文件触发了局部索引重建。
? 验证是否成功
创建一个标准测试类验证环境是否就绪：
package uniTesting;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
class ExampleTest {
@Test
void shouldPass() {
assertTrue(true);
}
}若 @Test 和 assertTrue 无报错，且右键可正常运行该测试（显示绿色三角形 ▶️），即表示 JUnit 5 已被完全识别。
? 补充建议
- 使用 Maven Surefire 插件（推荐 ≥3.0.0-M9）以兼容 JUnit 5：
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>3.0.0-M10</version> </plugin> - 检查项目 SDK 和语言级别是否匹配（如
19 要求 JDK 19+，且 IntelliJ Project SDK 已设为 JDK 19）。
遵循以上步骤，99% 的 “JUnit libraries not recognized” 问题均可彻底解决——核心逻辑是：让 IDE 理解「这是测试代码」，并确保「测试依赖已按测试作用域加载」。
