Java环境搭建三步：下载LTS版JDK（推荐JDK 17/21）、安装到无中文空格路径、正确配置JAVA_HOME和Path变量；Windows配系统变量，macOS/Linux改shell配置文件并source生效。
想一次搞定 Java 环境搭建，核心就三步：下对 JDK、装对位置、配对环境变量。很多问题其实不是操作错，而是路径写错、变量名打错、或者改了没刷新终端——下面按 Windows 主流流程讲清楚，macOS 和 Linux 的关键差异也标出来。
JDK 下载与安装：选 LTS 版，用安装包
别下 ZIP 包，新手直接选官方 .exe 安装程序（Windows）或 .dmg/.pkg（macOS），它会自动注册注册表或系统路径，大幅降低出错概率。
- 官网地址：https://www.oracle.com/java/technologies/downloads/ 或 https://adoptium.net/（推荐 Eclipse Temurin，开源免费，支持长期更新）
- 版本选 JDK 17 或 JDK 21（都是 LTS 长期支持版），避开 Java 8（太老）、Java 22+（非LTS，部分工具暂不兼容）
- 安装时建议保持默认路径，比如 Windows 默认是
C:\Program Files\Java\jdk-21；路径里不含中文、空格、特殊符号，否则后续容易报错
JAVA_HOME 和 Path 必须配全
只配 Path 不配 JAVA_HOME，或 JAVA_HOME 指向错误目录（比如指向 jre 文件夹、或少写了 jdk-21 这一级），都会导致 javac 找不到、Maven 报错、IDE 识别失败。
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
-
JAVA_HOME：新建系统变量，变量名严格写
JAVA_HOME，变量值填 JDK 安装的根目录（不含\bin），例如：C:\Program Files\Java\jdk-21 -
Path：编辑现有 Path 变量，新增一行：
%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux） - 不要手动写死完整路径如
C:\...\jdk-21\bin，否则换版本时要改两处；用%JAVA_HOME%是为了可维护
验证与排错：关掉再打开命令行
配置完必须关闭所有已打开的 CMD/PowerShell/Terminal 窗口，重新打开一个，否则环境变量不会生效。
立即学习“Java免费学习笔记（深入）”；
- 执行
java -version：显示版本号说明运行环境 OK - 执行
javac -version：显示版本号说明编译器可用（这是检验%JAVA_HOME%\bin是否进 Path 的关键） - 如果
java行、javac不行，90% 是 JAVA_HOME 路径错了，或 Path 里漏了%JAVA_HOME%\bin - 在 CMD 中输入
echo %JAVA_HOME%可快速检查变量是否读取正确
macOS / Linux 用户注意两个细节
它们不用“系统变量”界面，而是靠 shell 配置文件，但逻辑完全一致。
- 先确认用的是什么 shell：
echo $SHELL（zsh 是 macOS Catalina 后默认，bash 在旧系统或 Linux 常见） - 把这两行加到
~/.zshrc（zsh）或~/.bashrc（bash）末尾：
export PATH=$JAVA_HOME/bin:$PATH
- 保存后运行
source ~/.zshrc（或对应文件）立即生效，不用重启终端 - Linux 用户若用 apt/yum 安装 OpenJDK，JAVA_HOME 通常在
/usr/lib/jvm/java-11-openjdk-amd64这类路径，可用readlink -f $(which java) | sed "s:/bin/java::"快速查出
