VS Code 运行 Java 项目需同时满足三条件：正确配置 JDK（通过 JAVA_HOME 或 java.home 设置，版本 ≥11）、安装官方 Java Extension Pack、项目结构符合 Maven/Gradle 或标准 src/main/java 布局；缺一则报错。
VS Code 本身不内置 Java 运行环境，运行 Java 项目必须手动配置 JDK + 安装扩展 + 正确组织项目结构——缺一不可，否则 java 命令报错、ClassNotFoundException、或“找不到主类”都是大概率事件。
确认已安装并识别 JDK
VS Code 不会自动找 JDK，它依赖系统 JAVA_HOME 或用户在设置中显式指定路径。常见错误是：明明装了 JDK 17，但 VS Code 仍用自带的 JRE 或旧版本（如 JDK 8）导致 Unsupported class file major version。
- 终端执行
java -version和javac -version，确保输出一致且版本 ≥ 11（推荐 17/21） - 检查
JAVA_HOME是否指向 JDK 根目录（不是jre/子目录），Windows 用户注意路径末尾不要加反斜杠 - 在 VS Code 设置里搜索
java.home，填入绝对路径，例如：C:\Program Files\Java\jdk-17.0.2（Windows）或/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home（macOS）
安装必要扩展：Extension Pack for Java
单装 “Java Extension Pack” 是最简方案，它自动包含 Language Support for Java、Debugger for Java、Test Runner for Java 等核心组件。不装这个包，F5 调试、Ctrl+Click 跳转、甚至 Run Java 右键菜单都不会出现。
- 在 Extensions 视图（
Ctrl+Shift+X）中搜Extension Pack for Java，认准 Red Hat 官方发布者 - 安装后重启 VS Code，打开一个
.java文件，状态栏右下角应显示 JDK 版本号；若显示 “No Java runtime…”，说明java.home未生效 - 避免混装其他独立 Java 插件（如单独装 “Java Test Runner”），可能引发冲突或命令重复注册
项目结构必须符合 Maven/Gradle 或标准 layout
VS Code 的 Java 支持默认按构建工具约定解析源码路径。直接打开一个散装 .java 文件夹，即使有 main 方法，右键也看不到 Run Java —— 因为它没识别出这是个“项目”。
立即学习“Java免费学习笔记（深入）”；
- 推荐用 Maven 初始化：
mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart，然后用 VS Code 打开demo/根目录 - 若不用构建工具，至少保证结构为：
src/main/java/xxx/YourClass.java，并在 VS Code 中打开src的父级文件夹（即含src/的那个目录） -
public static void main(String[] args)必须在顶层类中，且类名与文件名严格一致；嵌套类、default类或文件名含空格都会导致运行失败
运行方式：优先用终端，慎用右键“Run Java”
右键菜单里的 Run Java 本质是调用 java 命令，但它对 classpath、模块路径、JVM 参数控制极弱，复杂项目极易失败。调试和正式运行建议回归终端。
- 编译：
javac -d out src/main/java/com/example/App.java（手动）或mvn compile（Maven） - 运行：
java -cp out com.example.App（注意 classpath 指向out/，不是.java文件） - 调试：按
F5→ 选Java→ 自动生成.vscode/launch.json，可在此添加vmArgs（如-Xmx512m）或args（程序参数） - 如果右键没反应，先确认文件是否被识别为 Java（右下角语言模式是否为
Java；不是则点击切换）
真正卡住人的往往不是语法，而是 JDK 路径没配对、项目没按约定放、或者误把普通文件夹当项目打开。每一步都建议用终端验证：能 javac 编译成功，再进 VS Code 才有意义。
