错误做法是硬编码JAVA_HOME路径，正确做法是用/usr/libexec/java_home -v 17动态获取并写入.zshrc，PATH必须设为$JAVA_HOME/bin:$PATH，追加后需source ~/.zshrc并验证java -version、echo $JAVA_HOME、which java三者一致。
用echo追加JAVA_HOME到.zshrc时路径写错
直接echo 'export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home' >> ~/.zshrc是危险操作——硬编码路径在升级JDK后立刻失效，且不同厂商（Temurin/Zulu/Oracle）的目录名不一致，比如temurin-17.jdk和jdk-17.jdk根本不是一回事。
正确做法是用/usr/libexec/java_home动态生成路径：
- 先查可用版本：
/usr/libexec/java_home -V - 确认目标版本存在（比如输出里有
17.0.2），再执行：echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc - 别漏掉
-v 17参数——不指定版本时，/usr/libexec/java_home可能返回最新版（比如21），而你实际想用17
echo追加PATH时顺序颠倒导致java命令仍调用系统旧版
echo 'export PATH=$PATH:$JAVA_HOME/bin' >> ~/.zshrc会让/usr/bin/java永远优先于你配的JDK，因为系统自带的/usr/bin在PATH前面。Maven、Gradle等工具会因此报错“Unsupported class file major version”，哪怕java -version看起来是对的。
必须把$JAVA_HOME/bin放在最前：
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 正确写法：
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.zshrc - 追加后记得
source ~/.zshrc，然后立刻验证：which java输出应为/Library/Java/JavaVirtualMachines/xxx/Contents/Home/bin/java，而非/usr/bin/java - 如果
which java仍是/usr/bin/java，说明前面已有其他PATH设置覆盖了你这行，得检查.zshrc里是否重复写了PATH
echo追加后没生效，以为配置失败其实是shell没重载
很多人执行完echo ... >> ~/.zshrc就直接开新终端测试，结果echo $JAVA_HOME为空——新终端确实会读.zshrc，但当前终端不会自动加载刚写入的内容。
必须手动触发重载：
- 运行
source ~/.zshrc（不是source ~/.bash_profile，除非你改的是bash） - 验证是否真生效：
echo $JAVA_HOME和java -version要同时看，且which java路径必须匹配$JAVA_HOME/bin/java - 图形界面IDE（如IntelliJ）通常不继承当前终端环境，改完后必须重启IDE，否则它仍用旧的
JAVA_HOME
多个echo追加导致重复export或变量冲突
反复运行echo 'export JAVA_HOME=...' >> ~/.zshrc会在文件末尾堆出几十行重复的export，轻则PATH越来越长，重则JAVA_HOME被最后一条覆盖成错误路径。
安全做法是先清理再追加：
- 删掉旧配置：
sed -i '' '/JAVA_HOME/d' ~/.zshrc（macOS的sed语法，-i ''不能省） - 再追加新行：
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc - 或者更稳妥：用
nano ~/.zshrc手动删掉所有含JAVA_HOME或PATH=的行，再一次性写入两行标准配置
真正容易被忽略的不是怎么写，而是写完之后没验证三者一致性：java -version、echo $JAVA_HOME、which java——只要有一个对不上，构建工具和IDE就会出问题。
