VS Code运行Java失败主因是java.home路径错误、JDK版本与插件不兼容或JAVA_HOME未正确定义；必须指向含bin/lib/conf的JDK根目录，路径需转义且不含空格/中文，配置后须重启VS Code。
VS Code 配 Java 不是装个插件就完事，真正卡住你的，八成是 JAVA_HOME 指向错误、java.home 路径没转义，或者 JDK 版本和插件不兼容——这些问题在你点下“运行”按钮前就已经决定了成败。
验证系统级 JAVA_HOME 是否生效
VS Code 的 Java 插件不会自己猜 JDK 在哪，它第一眼就看操作系统是否正确定义了 JAVA_HOME。这个变量必须指向完整的 JDK 根目录（不是 JRE，也不是 bin 子目录），且路径中不能有空格或中文（Windows 上尤其容易栽在这儿）。
操作建议：
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- Windows：打开新 CMD（不是旧终端），运行
echo %JAVA_HOME%和java -version，两行输出都应正常；若报“命令未找到”，说明Path里没加%JAVA_HOME%in - macOS/Linux：在终端运行
echo $JAVA_HOME，再执行ls $JAVA_HOME/bin/javac，必须能看到文件；如果用 Homebrew 安装 Temurin，路径通常是/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home，不是/usr/libexec/java_home的输出结果 - 常见坑：
JAVA_HOME指向C:Program FilesJavajre1.8.0_301——这是错的，JRE 不含javac，插件会静默失败
VS Code 中 java.home 设置要严格匹配路径规范
即使系统 JAVA_HOME 正确，VS Code 仍可能用错 JDK，因为它的 java.home 设置优先级更高，且对路径格式极其敏感。
立即学习“Java免费学习笔记（深入）”；
操作建议：
- Windows 用户必须用双反斜杠转义，例如：
"java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot"；写成单斜杠或正斜杠会导致插件加载失败，但无明确报错 - macOS/Linux 用户路径用正斜杠，但注意：zsh/bash 配置中
export JAVA_HOME=...的值，和 VS Codesettings.json里的java.home值可以不同——前者影响终端命令，后者只影响插件行为 - 别依赖自动检测：按
Ctrl+Shift+P输入Java: Configure Java Runtime，选 “Add JDK” 手动定位，比靠插件扫描更可靠 - 多个 JDK 共存时，
java.home必须显式指定，否则可能默认用上旧版本（比如你装了 JDK 21，但插件悄悄用了系统自带的 JDK 11）
Extension Pack for Java 对 JDK 版本有硬性要求
新版插件（如 Language Support for Java™ by Red Hat v0.65+）已放弃对 JDK 8 的支持，这不是警告，是直接拒绝加载——你会看到编辑器里满屏红波浪线，但控制台不报具体错误。
操作建议：
- 查清你装的插件版本：打开扩展面板 → 点击 “Java Extension Pack” → 看右下角版本号；v0.28.x 支持 JDK 8，v0.65+ 只支持 JDK 11+（含 17、21）
- 如果必须用 JDK 8，不要升级插件，或手动降级：点击扩展右上角 “…” → “Install Another Version” → 选 v0.28.0 左右的旧版
- Temurin、Zulu、Amazon Corretto 等 OpenJDK 发行版均可，但 Oracle JDK 需确认是否含完整调试符号（某些精简版会缺失
dt_socket，导致断点失效） - 插件启动时会拉起一个叫
jdt.ls的语言服务器进程，可在 VS Code 输出面板（Ctrl+Shift+U）里切换到 “Java” 查看日志；若看到UnsupportedClassVersionError，基本就是 JDK 版本太低
运行 Java 文件时终端环境和插件环境不一致
你点绿色三角形能跑，但终端里敲 java HelloWorld 报错“找不到主类”，或者反过来——这说明插件用的是一套 classpath，终端用的是另一套，两者根本没同步。
操作建议：
- 插件运行时默认使用模块化 classpath（基于
.classpath或pom.xml），而终端命令依赖当前 shell 的CLASSPATH和java -cp参数；别指望它们自动一致 - 简单单文件开发时，推荐统一用插件方式：保存
.java后直接按Ctrl+F5，它会自动调用javac编译再java运行，路径、编码、模块参数全托管 - 需要终端调试时，在 VS Code 内置终端（
Ctrl+`）里操作，并确保该终端已加载了正确的 shell 配置（如 macOS 上检查是否执行过source ~/.zshrc） - 如果项目含
module-info.java，终端运行必须加--module-path和--module，插件则自动处理；这时硬切终端命令反而容易漏参数
最常被忽略的一点：JDK 安装后必须重启 VS Code，而不是仅重载窗口——插件进程（jdt.ls）是在启动时读取 java.home 的，改完配置不重启，等于没改。
