Mac配置JDK需三步：1.确认shell类型（zsh用~/.zshrc，bash用~/.bash_profile）；2.用/usr/libexec/java_home -v 17 -F动态设JAVA_HOME防路径硬编码；3.将$JAVA_HOME/bin置PATH首位并验证java -version与which java。

Mac 上配置 JDK 不是简单复制粘贴路径就能完事，关键在三点：选对 shell 配置文件、用对 JAVA_HOME 获取方式、避免路径硬编码。

确认你用的是 zsh 还是 bash

macOS Catalina（10.15）起默认 shell 是 zsh，配置文件是 ~/.zshrc；老系统或手动改过可能是 bash，对应 ~/.bash_profile。
终端输入：

echo $SHELL

如果输出 /bin/zsh，就编辑 ~/.zshrc；如果是 /bin/bash，就编辑 ~/.bash_profile。

正确设置 JAVA_HOME（不写死路径）

Homebrew 安装的 OpenJDK（如 openjdk@17）路径会随升级变动，不能直接写 /usr/local/opt/openjdk@17/...。
必须用系统命令动态获取：

/usr/libexec/java_home -v 17

如果返回路径，说明该版本已注册；若报错 No Java runtime present，需先软链注册：

sudo ln -sfn /usr/local/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

然后在 ~/.zshrc（或对应配置文件）中添加：

立即学习“Java免费学习笔记（深入）”；

export JAVA_HOME=$(/usr/libexec/java_home -v 17 -F)
export PATH=$JAVA_HOME/bin:$PATH

注意：

Alibabacloud Sdk Client Initialization For Java

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

下载

• -F 参数防止路径含空格时出错
• $() 是命令替换，不能加引号包裹整个表达式
• $JAVA_HOME/bin 必须放在 PATH 最前面，否则可能调到系统 stub（/usr/bin/java）

生效并验证

保存后运行：

source ~/.zshrc

新开一个终端窗口，再执行：

java -version
which java
echo $JAVA_HOME

java -version 应显示你指定的版本（如 17.0.x），which java 应指向 $JAVA_HOME/bin/java，而不是 /usr/bin/java。

多版本共存时快速切换（可选）

如果你装了 JDK 8、11、17、22 等多个版本，可以提前定义别名：

export JDK8_HOME=$(/usr/libexec/java_home -v 8)
export JDK17_HOME=$(/usr/libexec/java_home -v 17)
alias jdk8='export JAVA_HOME=$JDK8_HOME; export PATH=$JAVA_HOME/bin:$PATH'
alias jdk17='export JAVA_HOME=$JDK17_HOME; export PATH=$JAVA_HOME/bin:$PATH'

之后在终端输入 jdk17 就能即时切换。

不复杂但容易忽略细节。