java默认编译版本由java_home、命令行javac路径及maven/gradle显式配置共同决定；三者必须统一为同一jdk版本（如17），否则易出现编译通过但运行报错或ide正常而终端失败等问题。
Java 默认编译版本由三者共同决定：系统级 JAVA_HOME + 命令行调用的 javac 版本 + 项目构建工具（如 Maven）的显式配置。只改其中一项，容易出现“编译通过但运行报错”或“IDE 正常而终端编译失败”的情况。
确保命令行默认使用目标 JDK 编译
这是最基础的一环，直接影响 javac 命令行为：
- 设置 JAVA_HOME 指向你希望作为默认的 JDK 根目录（例如
C:\Program Files\Java\jdk-17.0.2或/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home），路径末尾不能带\bin - 将
%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux）添加到 PATH 开头位置，确保它优先于系统自带的 java 或旧版 JDK 路径 - 关闭所有已打开的终端/命令提示符，新开一个，执行：
java -version和javac -version
二者输出版本号必须一致，且是你期望的版本（如 17.0.2）
统一 IDE 中的 Project SDK 与字节码版本
IntelliJ IDEA 或 Eclipse 的编译行为不读取 JAVA_HOME，而是依赖自身配置：
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 在 IDEA 中：File → Project Structure → Project
确认三项匹配：
— Project SDK：选中你安装的 JDK 17（不是 JRE）
— Project language level：选 “17”（非 “17 (Preview)” 除非你明确要用预览特性）
— Project bytecode version：默认跟随 language level，建议保持为 17，避免手动下调引发兼容性误解 - 特别注意：若模块（Modules）页签里单独设置了 Language level，它会覆盖 Project 级设置，需一并检查
- Eclipse 中：Window → Preferences → Java → Installed JREs → 添加完整 JDK 路径（含
bin/javac），并设为默认；再进项目 Properties → Java Build Path → Libraries → 修改 JRE System Library 为该 JDK
约束 Maven/Gradle 构建时的源码与目标版本
即使 JDK 是 17，Maven 默认可能按 Java 8 兼容方式编译，导致 API 调用失败或运行时报错：
- Maven：在
pom.xml的<properties></properties>中显式声明：<maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target>
推荐同时加<maven.compiler.release>17</maven.compiler.release>（替代 source/target），它能强制限制 API 使用范围，防止误调高版本类库 - Gradle：在
build.gradle中设置：java { sourceCompatibility = JavaVersion.VERSION_17; targetCompatibility = JavaVersion.VERSION_17 }
避免常见冲突点
很多“明明配了 JDK 17 却还报错 UnsupportedClassVersionError”的问题，根源在这里：
- 终端中
which javac（macOS/Linux）或where javac（Windows）返回的路径不是你预期的 JDK 17 的bin目录 → 检查 PATH 顺序和残留旧路径 - IDE 运行配置（Run Configuration）里单独指定了 JRE → 需手动改为 Project SDK 对应的 JDK
- 某些 CI 工具（如 Jenkins）或容器镜像自带 JDK，覆盖了宿主机配置 → 应在构建脚本中显式指定
JAVA_HOME和PATH - 用了
<source>/<target></target></source>却没配<release></release>→ 导致编译通过但调用了 JDK 17 不向下兼容的内部 API
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
