Java开发环境搭建通常需配置JAVA_HOME和PATH：前者供构建工具定位JDK，后者使命令行可直接执行javac/java；两者须指向同一JDK版本且缺一不可，仅java -version成功不代表配置完整。
Java开发环境搭建不一定必须手动配置环境变量，但绝大多数实际开发场景下，你绕不开 JAVA_HOME 和 PATH 的配置——尤其是当你需要命令行编译、运行 Java 程序，或使用 Maven、Gradle、IDE（如 IntelliJ 或 Eclipse）调用 JDK 工具时。
什么时候可以跳过手动配置？
现代 IDE（如 IntelliJ IDEA、Eclipse）自带嵌入式 JDK 或允许你指定 JDK 路径，此时它们不依赖系统级的 JAVA_HOME 或 PATH 就能完成编译和调试。但注意：
- IDE 内部运行
javac或java命令时，若未显式绑定 JDK，仍会 fallback 到系统 PATH 查找； - Maven 构建（
mvn compile）默认读取JAVA_HOME，没配好会报错The JAVA_HOME environment variable is not defined correctly； - 某些脚本（如 Spring Boot 的
spring-boot-maven-plugin启动类、CI/CD 流水线中的 shell 步骤）直接调用java -version，没进 PATH 就会失败。
JAVA_HOME 和 PATH 分别管什么？
JAVA_HOME 是一个约定俗成的“指向 JDK 根目录”的环境变量（例如 /usr/lib/jvm/java-17-openjdk-amd64 或 C:\Program Files\Java\jdk-17.0.1），多数构建工具和脚本靠它定位 bin、lib 等子目录；PATH 则决定终端能否直接敲 javac 或 java 执行命令。
- 只配
PATH不配JAVA_HOME：命令行可用，但 Maven/Gradle 可能报错； - 只配
JAVA_HOME不加$JAVA_HOME/bin到PATH：Maven 认得 JDK，但你在终端敲javac会提示 “command not found”； - 两者都配，且指向同一 JDK 版本：最稳妥，覆盖 CLI、构建工具、IDE 外部工具链等全部场景。
Windows / macOS / Linux 配置差异要点
不同系统写法和生效方式不同，容易踩坑：
立即学习“Java免费学习笔记（深入）”；
- Windows：在“系统属性 → 高级 → 环境变量”里新增
JAVA_HOME（值为 JDK 解压/安装目录，不含\bin），再编辑PATH加入%JAVA_HOME%\bin；改完需重启 CMD 或 PowerShell； - macOS（zsh 默认）：在
~/.zshrc中写export JAVA_HOME=$(/usr/libexec/java_home -v 17)（推荐用java_home命令自动查路径），再加export PATH=$JAVA_HOME/bin:$PATH；改完执行source ~/.zshrc； - Linux（bash/zsh）：类似 macOS，但
/usr/libexec/java_home不存在，需手动指定路径，如export JAVA_HOME=/opt/jdk-17.0.1；注意权限和符号链接问题（比如/usr/bin/java是软链，JAVA_HOME必须指向真实 JDK 目录）。
验证是否配对成功？别只信 java -version
仅运行 java -version 成功，不代表配置完整。真正要检查三件事：
echo $JAVA_HOME which java javac -version
三者输出应一致指向同一 JDK 版本。常见错误包括：
-
JAVA_HOME指向 JRE 而非 JDK（导致javac找不到）； -
PATH里有多个 Java bin 目录（旧版本优先），造成java -version和javac -version版本不一致； - IDE 启动脚本（如
idea.sh）绕过了用户 shell 配置，需在 IDE 设置中单独指定 JDK。
最常被忽略的是：JDK 多版本共存时，JAVA_HOME 和 PATH 的指向必须严格一致，且不能依赖系统默认软链——很多问题就出在你以为配好了，其实 javac 走的是另一个 JDK 的 bin。
