Homebrew安装OpenJDK@17后需手动配置PATH和JAVA_HOME：将export JAVA_HOME=$(/usr/libexec/java_home -v 17)与export PATH=$JAVA_HOME/bin:$PATH加入~/.zshrc，再source生效；若/usr/libexec/java_home -v 17无输出，需先执行sudo ln -sfn $(brew --prefix openjdk@17)/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk注册。
不是Homebrew没装好，而是它根本没动你的PATH和JAVA_HOME——它只装二进制，不改环境。
为什么which java能查到但java命令仍报“command not found”
现象：执行 brew install openjdk@17 成功，但新开终端敲 java -version 报错“command not found”。
原因在于Homebrew把 java 可执行文件放到了它自己的路径（如 /opt/homebrew/opt/openjdk@17/bin/java），但这个路径没加进你的 PATH 环境变量里。系统压根不知道去哪找它。
- Homebrew安装后不会自动修改任何shell配置文件（
~/.zshrc、~/.bash_profile等） -
which java在刚装完时可能返回空，因为PATH里还没有对应目录 - 某些旧终端窗口即使重开，也可能缓存了旧的PATH，必须彻底关闭再启新终端
macOS上必须手动把JDK bin目录加进PATH
Homebrew安装的OpenJDK不会向系统注册为“可用Java”，也不会软链到 /usr/bin/java。你得自己告诉shell去哪里找命令。
立即学习“Java免费学习笔记（深入）”；
- 先确认JDK真实bin路径：
brew --prefix openjdk@17→ 得到类似/opt/homebrew/opt/openjdk@17；该路径是符号链接，真实bin在$(brew --prefix openjdk@17)/bin - 编辑
~/.zshrc（M1/M2/M3默认shell）或~/.bash_profile（Intel老用户） - 添加这两行（注意顺序，
$JAVA_HOME/bin必须放在$PATH前面，否则可能被旧版本覆盖）：export JAVA_HOME=$(/opt/homebrew/opt/openjdk@17/bin/java -XshowSettings:properties -version 2>&1 | grep "java.home" | cut -d'=' -f2 | tr -d ' ')<br>export PATH=$JAVA_HOME/bin:$PATH
- 更稳妥的做法是用系统自带的
/usr/libexec/java_home：export JAVA_HOME=$(/usr/libexec/java_home -v 17)<br>export PATH=$JAVA_HOME/bin:$PATH
常见误操作：PATH加对了，但JAVA_HOME指向错误路径
很多教程让你直接写死 export JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.2/libexec/openjdk.jdk/Contents/Home ——这极容易失效。
-
/opt/homebrew/Cellar/...是具体版本路径，每次brew upgrade openjdk@17后会变，硬编码必然断掉 -
/opt/homebrew/opt/openjdk@17是稳定符号链接，但它本身不是JDK Home，真正Home在$(brew --prefix openjdk@17)/libexec/openjdk.jdk/Contents/Home - 用
/usr/libexec/java_home -v 17是最安全的选择，它由系统维护，能穿透Homebrew的符号链接层级，返回真实JDK根目录 - 如果
/usr/libexec/java_home -v 17返回空，说明系统尚未识别该JDK——运行一次sudo ln -sfn $(brew --prefix openjdk@17)/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk可修复
最易被忽略的一点：Homebrew装的OpenJDK默认不向 /Library/Java/JavaVirtualMachines/ 注册，所以 /usr/libexec/java_home 可能看不见它，除非你手动软链或用 brew reinstall openjdk@17 触发一次重注册。别假设“装了就等于可用”，Mac上JDK的可见性是分层的：命令行PATH、JAVA_HOME、系统级JVM注册，三者缺一不可。
