vscode的java.home仅影响ide行为，maven实际使用java_home或-dmaven.compiler.executable指定的jdk；二者不一致会导致编辑器无报错但mvn compile失败，需通过pom.xml配置maven-compiler-plugin的release参数并确保jdk版本匹配。
VSCode 的 java.home 和 Maven 实际用的 JDK 不是一回事
VSCode 里设置 java.home（比如在 settings.json 或左下角 Java Project 配置中）只影响 Language Server 的语法检查、跳转、调试启动这些 IDE 行为。它不会让 mvn compile 命令自动切到那个 JDK —— Maven 自己认的是系统环境变量 JAVA_HOME，或者你显式传的 -Dmaven.compiler.executable。
常见错误现象：VSCode 编辑器里写 var 没红波浪线，但终端里跑 mvn compile 直接报 Fatal error compiling: invalid target release: 17。
- 先确认
JAVA_HOME指向哪：终端执行echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows） - 再查 Maven 真正调用的
javac路径：运行mvn -X compile 2>&1 | grep "Using Java version" - 如果两者不一致，说明 IDE 和构建工具“各干各的”，必须手动对齐
pom.xml 里只配 source 和 target 是不够的
Java 9+ 引入了 release 参数，它比 source/target 更严格：不仅控制语法版本，还强制限制 API 使用范围（比如禁止调用 JDK 17 新增但尚未稳定发布的内部 API）。Maven 默认不启用它，仅靠 <maven.compiler.source>17</maven.compiler.source> 无法规避 UnsupportedClassVersionError。
正确做法是升级 maven-compiler-plugin 并启用 release：
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><version>3.11.0</version><configuration><release>17</release></configuration></plugin>
-
release必须和你本地 JDK 主版本号完全一致（如用 JDK 17 就填17），否则编译直接失败 - 低于 3.8 版本的插件不支持
release，会忽略该配置，退回到宽松的source/target模式 - 如果项目需兼容多 JDK（如 CI 用 JDK 17，但某些模块要跑在 JDK 11 上），
release反而会限制太死，此时才考虑退回source/target+ 显式指定fork和executable
VSCode 插件自动导入项目时会忽略 settings.xml 的 JDK 配置
Maven 的 settings.xml 文件可以定义 <profiles></profiles> 和 <activeprofiles></activeprofiles>，但 VSCode 的 Java 扩展（Language Server）在首次加载项目时，并不会读取这些 profile 中的 JDK 配置。它只认 pom.xml 里的插件配置和系统级 JAVA_HOME。
这意味着：即使你在 settings.xml 里写了 <property><name>java.home</name><value>/path/to/jdk17</value></property>，VSCode 也不会照着用。
- 解决方法只有两个：要么把 JDK 切换逻辑写进
pom.xml（推荐），要么确保JAVA_HOME指向目标 JDK - 如果团队多人协作且 JDK 路径不统一，别依赖
JAVA_HOME，改用 Maven Toolchains：在pom.xml中声明<toolchains></toolchains>，并在用户目录下建~/.m2/toolchains.xml绑定具体路径 - VSCode 重启后，务必执行 “Java: Clean Java Language Server Workspace” 再重新导入项目，否则旧缓存可能继续用错 JDK
终端里 mvn 成功但 VSCode 插件报错，大概率是插件没读到 MAVEN_OPTS
有些企业环境通过 MAVEN_OPTS 设置 JVM 参数（比如 -Djavax.net.ssl.trustStore=...），或强制指定 JDK（-Djdk.home=/path/to/jdk）。VSCode 的 Maven 插件默认不继承这个环境变量，导致它启动的 Maven 进程和你在终端里手动跑的不是同一套参数。
验证方式：打开 VSCode 的 Output 面板 → 切换到 Maven 标签页，看插件执行命令时是否包含你设的 MAVEN_OPTS。
- 若缺失，在 VSCode 的
settings.json中添加："maven.terminal.customEnv": [{"name": "MAVEN_OPTS", "value": "-Djdk.home=/path/to/jdk17"}] - 注意：这个配置只影响 VSCode 内置终端和插件触发的 Maven 命令，不影响你手动打开外部终端执行的
mvn - Windows 用户尤其要注意路径分隔符：
MAVEN_OPTS里用/而不是\，否则-Djdk.home=C:\jdk17会被解析成C:jd17
java.home、JAVA_HOME、pom.xml、settings.xml、MAVEN_OPTS 各管一摊，出问题时得挨个验证输出，不能只信某一处的“看起来正常”。Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
