VS Code中JUnit 5测试无法运行的根本原因有三：Test Runner for Java插件未真正启用、pom.xml缺失junit-jupiter-engine依赖（仅加api不够）、测试类未置于src/test/java且未满足命名与注解规范；需启用Extension Pack for Java、确保junit-jupiter版本≥5.10.0且scope为test、执行Java: Reload Project触发扫描。
VS Code 里跑不起来 JUnit 5 测试，基本不是代码问题，而是 Test Runner for Java 插件没真正加载、pom.xml 漏了 junit-jupiter-engine、或者测试类压根没进 test classpath——这三处任一出错，绿色 ▶ 按钮都不会出现。
Extension Pack for Java 必须完整启用且重载
VS Code 的 Java 测试能力是多个插件协同工作的结果，只装了 Language Support for Java 或 Debugger for Java 是不够的。Test Runner for Java 必须处于激活状态，且整个扩展包需完成初始化。
- 打开扩展面板（
Ctrl+Shift+X），搜索Extension Pack for Java，确认显示“已启用” - 右键该扩展 → “重新加载窗口”，避免插件因缓存未完全加载
- 检查状态栏左下角是否显示 JDK 版本（如
Java 17）；若为Unknown，说明java.home未正确配置，需运行命令面板中的Java: Configure Java Runtime - 执行一次
Java: Reload Project（Ctrl+Shift+P输入），这是触发测试扫描的强制动作，跳过它，src/test/java下的类不会被识别
pom.xml 必须声明完整的 junit-jupiter 依赖
很多人只加了 junit-jupiter-api，但 VS Code 的 Test Runner 实际靠 junit-jupiter-engine 来发现和执行测试。漏掉 engine 就会报 NoClassDefFoundError: org/junit/platform/engine/TestEngine 或 Test engine with ID 'junit-jupiter' failed to discover tests。
- 在
pom.xml的<dependencies></dependencies>中添加完整依赖（推荐5.10.3或更新）：
<dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter</artifactId> <version>5.10.3</version> <scope>test</scope> </dependency>
<scope>test</scope> 不可省略——Maven 仅在 test classpath 中提供该依赖，VS Code 依赖此路径加载测试引擎pom.xml → “Maven: Reload project”，或点击右下角弹出的 “Import changes” 提示junit-platform-console-standalone.jar 并配置路径：插件不支持该用法，会导致 ClassLoader 冲突测试类必须符合 Maven 标准结构与命名规范
VS Code 不像 IntelliJ 那样宽松，它严格依赖 Maven 目录约定和类路径解析逻辑。一个字符偏差，就可能让测试图标彻底消失。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 测试类必须放在
src/test/java目录下（不能是src/test或test/java） - 类名建议以
Test结尾（如CalculatorTest.java），或至少每个测试方法都标注@Test - 方法必须是
public void且无参数，导入org.junit.jupiter.api.Test - 如果项目用了模块化（有
module-info.java），测试模块中需显式声明：requires org.junit.jupiter.api;，否则编译期就失败 - 示例最小可运行片段：
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
class CalculatorTest {
@Test
void add_returnsCorrectResult() {
assertEquals(5, 2 + 3);
}
}
运行时 JDK 与项目编译 JDK 必须一致
运行时报 ClassNotFoundException: org.junit.jupiter.api.Test，往往不是依赖没加，而是 VS Code 启动测试时用的 JVM 和你项目编译用的 JDK 不一致，导致 classpath 对不上。
- 检查状态栏右下角显示的 JDK 版本（如
Java 17），必须和pom.xml中maven-compiler-plugin的<source></source>/<target></target>完全一致 - 在
.vscode/settings.json中可显式加固配置："java.configuration.updateBuildConfiguration": "interactive"，避免自动推断出错 - 如果项目使用多 JDK 环境（如同时装了 JDK 11 和 JDK 17），务必确认
java.home指向的是构建工具实际使用的那个版本
最常被忽略的是 Java: Reload Project 这一步——它不光刷新依赖，还重建测试索引。哪怕 pom.xml 和目录都对了，跳过它，VS Code 就当没看见你的测试类。
