UnsupportedClassVersionError错误源于编译与运行环境Java版本不匹配，核心解决方法是确保类文件编译版本不高于JVM支持的最高版本，具体包括统一JDK版本、正确配置java.home和java.configuration.runtimes、检查构建工具目标版本及验证字节码major version。
“JRE not found”或“No JVM installation found”
这是最常遇到的报错，90% 情况下不是 JDK 没装，而是 java.home 指向了错误路径。VS Code 的 Java 扩展完全不读取系统 PATH 或临时 JAVA_HOME，只认你手动填进配置里的那个绝对路径。
常见错误写法：
-
/usr/lib/jvm/java-17-openjdk-amd64/bin（错在指向bin子目录） -
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/jre（错在多加了/jre） -
C:\Program Files\Java\jre1.8.0_301（用 JRE 替代 JDK，扩展大概率启动失败）
正确做法是直接复用终端里 java -XshowSettings:properties -version 2>&1 | grep "java.home" 输出的值——它返回的就是 JDK 安装根目录，含 bin/、lib/、conf/（或 jre/）子目录。
“lambda expressions are not supported at this language level”
代码用了 Java 11+ 特性，但编辑器提示语法不支持，说明语言服务器加载的 JDK 版本低于项目要求。这通常是因为 java.home 和 java.configuration.runtimes 配置不一致，或者没在项目级生效。
立即学习“Java免费学习笔记（深入）”；
必须在项目根目录下创建 .vscode/settings.json（不是用户设置），写明两件事：
-
java.home：指定语言服务器启动所用的 JDK（影响补全、诊断） -
java.configuration.runtimes：列出编译/运行可选的 JDK，其中name必须匹配pom.xml里的maven.compiler.source或build.gradle中的java.toolchain.languageVersion
例如项目用 Java 21，但本地同时装了 JDK 11 和 21，配置里就得显式声明两个 runtime，并确保 name 是 "JavaSE-21"，否则 Maven 插件无法对齐。
“Unsupported class file major version”
运行时报这个错，说明字节码版本高于当前 JVM 能识别的范围。典型场景是：项目用 JDK 21 编译（生成 major version 65），但 VS Code 启动调试时实际调用的是 JDK 11 的 java 命令。
根本原因有三个：
-
java.home指向旧版 JDK，导致语言服务器和调试器都用错了 JVM -
java.configuration.runtimes里没包含项目所需版本，或name字符串拼写不一致（比如写成"Java 21"而非标准的"JavaSE-21"） - Maven 构建配置（如
pom.xml）中未声明<source>/<target>，导致编译器按默认 JDK 版本输出字节码
验证方式：运行 javap -verbose HelloWorld.class | grep "major" 看实际字节码版本，再比对 java -version 输出的 JVM 支持范围。
项目打开后满屏红色波浪线，但 java -version 正常
说明 Language Server 已启动，但没正确索引项目结构。这不是路径问题，而是元数据同步失败。
优先执行这两步：
- 打开命令面板（
Ctrl+Shift+P），运行Java: Clean Java Language Server Workspace - 确保你用的是
File > Open Folder打开整个项目根目录（含pom.xml或build.gradle），而不是单个.java文件
如果仍无效，检查 .vscode/settings.json 是否误把 java.home 写成相对路径，或路径中含中文、空格未用双引号包裹（Windows 尤其注意 C:\Program Files\ 这类路径）。
