java_home必须指向jdk根目录，即包含bin、lib、jre（或jmods）的顶层文件夹，不可为bin或jre子目录，也不能带尾斜杠；windows需在系统变量中新建java_home并添加%java_home%\bin到path，macos/linux推荐用/usr/libexec/java_home或固定路径并更新path，配置后须重启终端并验证echo、which/where、javac -version及构建工具版本一致性。

JAVA_HOME 必须指向 JDK 根目录，不是 bin，也不是 JRE，更不能带尾斜杠。

路径必须准确对应 JDK 安装结构

JDK 根目录是指包含 bin、lib、jre（或 jmods）三个子目录的最上层文件夹。例如：

• ✅ 正确：C:\Program Files\Java\jdk-17.0.1（Windows）
• ✅ 正确：/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home（macOS）
• ❌ 错误：C:\Program Files\Java\jdk-17.0.1\bin（指向 bin 会导致 javac 找不到）
• ❌ 错误：C:\Program Files\Java\jre-17.0.1（JRE 不含编译器，无法支持构建）

Windows 系统设置要点

必须通过「系统属性 → 高级 → 环境变量」在「系统变量」中新建，而非临时命令行设置：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 变量名写 JAVA_HOME（大小写不敏感，但惯例全大写）
• 变量值填完整路径，结尾不加反斜杠（如 C:\Java\jdk-21，不要写成 C:\Java\jdk-21\）
• 接着编辑 Path 系统变量，新增一行：%JAVA_HOME%\bin
• 改完后需重启 CMD/PowerShell 或 IDE，否则 echo %JAVA_HOME% 不生效

macOS/Linux 推荐动态写法

避免硬编码路径失效，尤其多版本共存时：

• macOS 推荐用系统工具自动定位：
  export JAVA_HOME=$(/usr/libexec/java_home -v 21)
• Linux 常见路径：
  export JAVA_HOME=/usr/lib/jvm/jdk-21
• 无论哪种，都要同步更新 PATH：
  export PATH=$JAVA_HOME/bin:$PATH
• 写入对应 shell 配置文件（~/.zshrc 或 ~/.bashrc），再执行 source 生效

验证是否真正生效

仅看 java -version 不够，要交叉确认：

• 运行 echo $JAVA_HOME（Linux/macOS）或 echo %JAVA_HOME%（Windows）——应输出你设定的路径
• 运行 which java 或 where javac ——结果路径应以 $JAVA_HOME/bin 或 %JAVA_HOME%\bin 开头
• 运行 javac -version ——确保编译器可用，排除只配了 JRE 的情况
• 若用 Maven/Gradle，检查 mvn -v 输出的 Java 版本是否与 java -version 一致

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南