vscode运行java需jdk、扩展、项目结构三者协同：java.home必须指向jdk根目录（非bin），须打开含pom.xml或标准src结构的项目根目录，run按钮依赖codelens识别public static void main所在顶层类。
VSCode 本身不运行 Java，它靠外部 JDK + 扩展 + 正确项目结构三者协同才能编译、运行、调试——缺一不可。装完 JDK 和插件却点不了 Run，大概率是卡在这三者的配合上。
java.home 必须指向 JDK 根目录，不是 bin 子目录
VSCode 的 Java 扩展（如 redhat.java）读取 java.home 路径时，会自动拼接 bin/java 和 bin/javac。如果填成 /path/to/jdk-17.0.1/bin，它就会去找 /path/to/jdk-17.0.1/bin/bin/java，直接报错。
- 正确路径示例：
/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home（macOS）、C:/Program Files/Java/jdk-17.0.1（Windows） - 验证方式：打开 VSCode 命令面板（
Ctrl+Shift+P），运行Java: Configure Java Runtime，看 “Installed JREs” 下是否显示你指定的路径且状态为 active - 常见坑：Windows 用户复制路径时带末尾反斜杠
\，导致解析失败；路径含中文或空格（尤其 Windows 默认装在C:\Program Files\...）可能触发权限或识别问题
必须打开项目根目录，不能只打开单个 .java 文件
VSCode 的 Java 扩展默认按 Maven/Gradle 约定发现项目——它靠 pom.xml 或 build.gradle 自动推导源码路径、依赖和 classpath。打开一个空文件夹或单个 HelloWorld.java，扩展根本不会激活 Java 语言服务器。
- 推荐做法：用命令行初始化标准结构，例如
mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart，然后用 VSCode 打开demo/目录 - 快速替代：按
Ctrl+Shift+P→ 输入Java: Create Java Project→ 选 Maven → 填 groupId/artifactId，自动生成src/main/java等结构 - 若坚持不用构建工具，至少保证目录为
./src/main/java/com/example/HelloWorld.java，并在 VSCode 中打开./（即含src/的父目录），再在.vscode/settings.json中加："java.project.sourcePaths": ["src/main/java"]
Run 按钮只出现在 public static void main 所在类的顶部 CodeLens
VSCode 不通过右键菜单或终端 java HelloWorld 运行 Java——它靠 Language Server 解析出主类后，在代码上方注入 Run、Debug 链接。没看到这些按钮？说明扩展没识别出主方法或项目结构无效。
- 前提条件：
public static void main(String[] args)必须写在顶层类中，且类名与文件名严格一致（如HelloWorld.java内必须是public class HelloWorld） - 常见失效场景：类在子包里但
package声明缺失或错误；main方法被注释或写在内部类里；项目刚打开未点击右下角弹出的 “Load project” 提示 - 别手动写
launch.json：除非你要传-Xmx或环境变量，否则完全不需要。CodeLens 是最稳的入口
JDK 版本不一致会导致 “Unsupported class file major version”
终端里 java -version 和 javac -version 输出版本号不同，或者 VSCode 显示的 JDK 版本和终端不一致，运行时大概率抛这个错——字节码版本不匹配。
- 查真实路径：
which java和which javac（macOS/Linux），或where java和where javac（Windows），确认两者指向同一 JDK 安装目录 - VSCode 启动方式影响环境变量读取：桌面图标启动可能读不到 shell 配置的
PATH和JAVA_HOME；建议从终端执行code .启动，确保继承当前 shell 环境 - 多 JDK 共存时，仅靠系统
JAVA_HOME不够可靠，必须在 VSCode 设置中显式填java.home，并禁用其他冲突插件（如单独安装的 “Java Test Runner”）
最容易被忽略的是：VSCode 的 Java 支持本质是“项目感知型”，不是“文件感知型”。它不关心你有没有写对 main 方法，只关心能不能从项目元数据里推导出可运行上下文——所以路径、结构、配置三者必须对齐，少一个环节，CodeLens 就不会出现。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
