VSCode运行Java失败90%因java.home路径错误、未装Extension Pack for Java或未打开项目文件夹；java.home必须指向JDK根目录（含bin/lib），不可填bin子目录、JRE路径或含空格/中文路径，且需在项目根目录的.vscode/settings.json中配置并重启VSCode。
VSCode 运行 Java 程序失败，90% 是因为 java.home 指向错误、没装对扩展包、或根本没打开项目文件夹——它不支持直接右键单个 .java 文件运行。
java.home 必须填 JDK 根目录，不是 bin，也不是 JRE
VSCode 的 Java 扩展完全不读系统 JAVA_HOME，也不 fallback 到 PATH；它只认你手动填进 java.home 的那个绝对路径。填错就卡在 “No Java runtime present” 或语言服务器起不来。
- ✅ 正确写法：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home"（macOS）、"java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.2-hotspot"（Windows） - ❌ 错误写法：
"java.home": "C:\jdk-17\bin"（到bin子目录）、"java.home": "D:\my jdk"（含空格/中文会静默失败）、"java.home": "C:\Program Files\Java\jre1.8.0"（JRE 不行） - 多 JDK 场景下，优先在项目根目录建
.vscode/settings.json写java.home，避免和其他项目冲突
必须装 Extension Pack for Java，别单独装子插件
单独启用 Language Support for Java™ 或 Debugger for Java 会导致功能断裂：Run 按钮不出现、断点灰色、import 标红但 mvn compile 能过——这是扩展间版本不匹配的典型症状。
- 去 Extensions 商店搜
Extension Pack for Java，认准发布者是vscjava（不是 Red Hat 单独发布的旧包，也不是第三方“Java IDE”） - 安装后必须重启 VSCode（不是重载窗口），否则 Language Server 不启动
- 首次打开
.java文件时，会自动下载约 100MB 的 Java language server，需稳定网络；若卡在 “Starting the Java Language Server”，先检查java.home是否真能访问（比如权限不足、路径不存在）
运行 Java 必须打开文件夹，不能只开单个 .java 文件
VSCode 的 Java 扩展对“裸文件”几乎不支持：右键 HelloWorld.java → Run Java，大概率报 No main class found 或 Cannot resolve classpath。它需要项目结构来推导源码路径、依赖和主类。
立即学习“Java免费学习笔记（深入）”；
- 正确做法：新建空文件夹 → 用 VSCode 打开该文件夹 →
Ctrl+Shift+P→ 输入Java: Create Java Project→ 选No Build Tools或Maven，自动生成src/等标准结构 - 如果已有代码，必须打开含
src/main/java或pom.xml的那一层父目录，而不是只打开src/main/java/com/example/Hello.java - 常见假成功：右键单个
.java文件 → Run Java 偶尔能出结果，但极不稳定；背后实际调用的是系统java命令，绕过了扩展的 classpath 管理，一旦有依赖或包声明就立即失败
验证是否配置成功：三处关键信号
别只看终端有没有输出，真正生效要看这三处：
- VSCode 状态栏左下角显示 JDK 版本号（如
17），说明java.home已加载且插件启动成功 - 打开任意
.java文件，在main方法上方出现▶️ Run | DebugCodeLens —— 没这个按钮，说明项目结构或插件没识别成功 -
Ctrl+Shift+P→ 输入Java: Configure Classpath能正常打开，说明 classpath 推导机制已就绪
最常被忽略的是：即使 java -version 和 javac -version 都能跑通，VSCode 仍可能因 java.home 路径层级不对或项目未以文件夹形式打开而彻底失效。
