VS Code中JUnit测试无法运行的主因是Extension Pack for Java未装全、pom.xml缺失junit-jupiter-engine依赖或测试类不在src/test/java下；需确保Test Runner插件启用、依赖完整（含api与engine）、版本≥5.10.3且scope为test，并验证JDK一致性及标准目录结构。
VS Code 里跑不起 JUnit 测试，八成不是代码写错了，而是 Extension Pack for Java 没装全、pom.xml 依赖漏了 junit-jupiter-engine、或者测试类根本不在 src/test/java 下——这三处对不上，绿色 ▶ 按钮就永远不会出现。
确认 Test Runner for Java 插件已加载
VS Code 不像 IntelliJ 自动激活测试支持。即使你装了 Extension Pack for Java，也得确保其中的 Test Runner for Java 实际在运行：
- 打开命令面板（
Ctrl+Shift+P），输入Java: Refresh Projects强制重载 Maven 配置 - 检查右下角状态栏是否显示 “Java” 和 JDK 版本（比如
JDK 17）；若显示 “No Java runtime found”，说明java.home未指向有效 JDK - 右键
pom.xml→ 选Maven: Reload project，观察右下角是否有 “Importing…” 提示 - 如果仍无反应，打开扩展面板，搜索
Test Runner for Java，确认未被禁用（禁用状态会显示灰色“已停用”）
检查 pom.xml 的 JUnit 5 依赖是否完整
只加 junit-jupiter-api 是不够的，junit-jupiter-engine 缺失会导致 NoClassDefFoundError: org/junit/platform/engine/TestEngine —— 这是 VS Code 启动测试时最常报的错误之一：
- 必须同时声明
junit-jupiter（BOM 包）或至少两个组件：junit-jupiter-api+junit-jupiter-engine -
scope必须为test，不能是compile或留空 - 版本推荐
5.10.3或更新（5.7+才支持 JDK 17+，旧版如5.4.2在 JDK 17 下直接失败） - 示例正确写法：
<dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter</artifactId> <version>5.10.3</version> <scope>test</scope> </dependency>
验证测试类位置与结构是否合规
VS Code 的测试发现机制很“死板”：它不扫描任意路径，只认标准 Maven 结构下的 src/test/java，且默认按命名或注解识别：
- 测试类必须放在
src/test/java/com/example/CalculatorTest.java这类路径下（不能是src/main/java） - 类名建议以
Test结尾（如CalculatorTest），否则必须每个方法都显式加@Test - 必须导入
org.junit.jupiter.api.Test，不能用 JUnit 4 的org.junit.Test - 方法签名必须是
public void xxx()，不能带参数、不能是static、不能返回值 - 如果项目用了模块化（
module-info.java），测试模块需添加requires org.junit.jupiter.api;
运行时报 ClassNotFoundException 或 No test runner found 怎么办
这类错误基本指向 classpath 分裂：VS Code 启动测试用的 JVM 和你编译项目用的 JDK 不一致，或没把 test classpath 加进去：
- 检查
settings.json中是否误设了java.testMethod—— 这个配置项并不存在，VS Code 不读它，删掉即可 - 确认
pom.xml里的maven-compiler-plugin的<source></source>和<target></target>与状态栏显示的 JDK 版本完全一致（比如都是17） - 避免手动往
lib/放junit.jar：VS Code 的 Java 测试支持只认 Maven/Gradle 管理的依赖，手拷 jar 会被忽略 - 重启 VS Code 窗口（不只是重载窗口），尤其在改完
java.home或插件启用状态后
真正卡住的地方往往藏在“以为配好了”的细节里：比如 src/test/java 目录是手动新建的但没被 Maven 标记为 test source root，或者 pom.xml 里 groupId 写成了 groupid（少了个 r）——这种拼写错误不会报红，但会让整个依赖失效。
