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 Files\Java\jdk-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 行为，结构松散就失去上下文。
