VSCode中怎么运行和测试Java项目？【教程】

vscode运行java项目需JDK11+、Java Extension Pack及标准项目结构。须配置java.home指向JDK根目录，安装扩展后重启，maven/gradle项目需含pom.xml或build.gradle，测试需Test Runner for Java支持。

VSCode 本身不内置 Java 运行环境，必须配合 JDK + 扩展 + 正确的项目结构才能运行和测试 Java 项目。光装插件或只配 JAVA_HOME 是不够的。

确认 JDK 已正确安装并被 VSCode 识别

VSCode 的 Java 支持依赖本地 JDK（11+ 推荐），且必须通过 java.home 显式指向 JDK 根目录（不是 JRE，也不能指向 bin/java）。

• 在终端执行 java -version 和 javac -version 确保输出一致且版本 ≥ 11
• 打开 VSCode 设置（Ctrl+,），搜索 java.home，设为类似 /usr/lib/jvm/jdk-17.0.1（linux/macOS）或 C:Program FilesJavajdk-17.0.1（windows）
• 重启 VSCode 后，打开一个 .java 文件，底部状态栏应显示 JDK 版本；若提示 “No Java runtime present”，说明路径错误或权限不足

用 Extension Pack for Java 安装必要扩展

单独安装 “Java Extension Pack” 是最稳妥的方式，它自动包含 Language Support for Java、Debugger for Java、Test Runner for Java 等核心组件，缺一不可。

• 不要只装 “Java” 单个插件——它只提供语法高亮，无法运行或调试
• 安装后首次打开 .java 文件会触发扩展初始化，可能需要几分钟下载 java-language-server，请保持联网
• 如果项目使用 Maven 或 Gradle，建议同时安装对应构建工具扩展（如 Extension Pack for apache Maven），否则右键 Run 可能灰显

项目结构必须符合标准布局才能被识别

VSCode 的 Java 扩展默认按 Maven/Gradle 约定识别源码路径。平铺多个 .java 文件或随意放 src 目录会导致“找不到主类”或“无法解析类型”。

立即学习“Java免费学习笔记（深入）”；

• Maven 项目：确保有 pom.xml，且 src/main/java 下有带 public Static void main(String[] args) 的类
• 非构建工具项目：手动创建 .vscode/settings.json，添加：

  {   "java.project.sourcePaths": ["src"],   "java.project.outputPath": "bin" }

• 右键某个 .java 文件 → Run Java，实际调用的是 java -cp bin com.example.Main；若报错 Error: Could not find or load main class，大概率是 classpath 或包声明不匹配

运行单测要用 Test Runner for Java，不是直接执行 main

VSCode 不支持像 IntelliJ 那样一键运行任意含 @Test 的方法——必须通过 Test Runner for Java（已包含在 Extension Pack 中）识别测试框架（junit 4/5 或 TestNG）。

• 确保测试类在 src/test/java，且依赖已声明（Maven 中需有 junit-jupiter）
• 测试方法必须有 @Test 注解，且不能是 private 或 static
• 将光标放在测试方法内，点击左上角“▶️ Run Test”按钮，或按 Ctrl+Shift+P → 输入 Java: Run Tests
• 若测试图标未出现，检查是否打开了正确的文件夹（必须是含 pom.xml 或 build.gradle 的根目录），且 java.test.library 设置为对应版本

最容易被忽略的是：VSCode 的 Java 运行依赖工作区根目录下存在有效构建配置。把一个 Main.java 拖进空文件夹再点运行，99% 会失败——它不是轻量级编辑器，而是靠扩展模拟 ide 行为，结构松散就失去上下文。