Java开发环境搭建失败主因是环境变量配置错误、多JDK版本冲突、IDE与构建工具JDK不一致、路径含空格或中文。需确保JAVA_HOME与PATH匹配、验证java/javac存在、统一IDE/Maven/Gradle的JDK版本，并避免空格路径。
Java开发环境搭建失败的常见原因分析
Java开发环境搭建失败，90%以上的情况不是因为“不会装”，而是因为几个关键环节被忽略或配置错位。最常卡在 java -version 不识别、javac 找不到、IDE 识别不到 JDK，或者 Maven 编译报 Unsupported class file major version。
PATH 和 JAVA_HOME 配置冲突
Windows 或 macOS 下手动配置环境变量时，PATH 和 JAVA_HOME 不一致是最隐蔽的坑。比如 JAVA_HOME 指向 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，但 PATH 却写成了 $JAVA_HOME/bin 的旧路径（如指向 jdk8），或者漏了 /bin 后缀。
-
JAVA_HOME必须是 JDK 安装目录的**根路径**，不能带/bin -
PATH中必须包含$JAVA_HOME/bin（Linux/macOS）或%JAVA_HOME%\bin（Windows） - 执行
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows）后，再用ls $JAVA_HOME/bin确认java和javac是否真实存在 - 重启终端或命令行窗口——环境变量不会自动刷新已打开的 shell
多个 JDK 共存导致版本混乱
系统里同时装了 OpenJDK 8、Adoptium 17、Zulu 21，又没设默认版本，java -version 和 javac -version 显示不一致，或 IDE（如 IntelliJ）自动选中了 JRE 而非 JDK。
- 运行
/usr/libexec/java_home -V（macOS）或update-alternatives --config java（Ubuntu）查看所有已注册 JDK - IntelliJ 中：File → Project Structure → Project → Project SDK → 点击 “+” 添加正确 JDK 路径，不要依赖自动探测
- Eclipse 中：Preferences → Java → Installed JREs → Add… → Standard VM → Directory 选到 JDK 根目录（含
bin和lib） - Maven 项目里若出现
Unsupported major.minor version，大概率是pom.xml中maven-compiler-plugin的source/target和实际 JDK 版本不匹配
IDE 自带 JRE 干扰或未启用项目级 JDK
很多开发者没意识到：IntelliJ 默认用 Bundled JDK 运行 IDE 自身，但它**不决定你项目的编译和运行环境**。项目仍可能沿用旧版 JDK，尤其从老项目导入时。
立即学习“Java免费学习笔记（深入）”；
- 检查
File → Project Structure → Modules → Sources：Language level 必须与所选 JDK 匹配（如 JDK 17 对应 Language level 17） - 检查
File → Settings → Build → Compiler → Java Compiler：Target bytecode version 应与 Module 的 Language level 一致 - Gradle 项目还要确认
gradle.properties中org.gradle.java.home是否指向目标 JDK；否则 Gradle 守护进程会用系统默认 JDK，和 IDE 设置脱节 - VS Code 用户注意：Java Extension Pack 会读取
java.home设置，该值必须是 JDK 路径，不能是 JRE
Windows 下 JDK 安装路径含空格或中文
某些工具链（尤其是老版本 Ant、部分 Shell 脚本或自定义构建脚本）无法正确解析带空格或中文的路径，表现为 Could not find or load main class 或 Unable to locate tools.jar。
ERROR: Could not find tools.jar Please check that /C:/Program Files/Java/jdk-17.0.1/lib/tools.jar exists
- 重装 JDK 到无空格、纯英文路径，例如
C:\dev\jdk-17 - 更新
JAVA_HOME和PATH中所有引用 - 避免使用官网下载的 .exe 安装包默认路径（它总倾向写进
Program Files）；改用 .zip 解压版更可控
真正难排查的，往往不是“哪里没配”，而是“哪里配了两遍还互相打架”。多查一次 which java、java -XshowSettings:properties -version、mvn -v，比重装三次 JDK 更省时间。
