Mac配置PATH环境变量需三点：一、用which brew或brew --prefix等命令确认程序真实路径；二、规范拼接PATH，如export PATH="/opt/homebrew/bin:$PATH"，避免覆盖系统路径；三、zsh用户修改~/.zshrc后执行source ~/.zshrc生效，并验证echo $PATH和which 命令。
Mac 系统中环境变量配置要指向正确路径，核心是三点：确认目标程序的实际安装位置、把该路径准确加进 PATH 变量、确保配置被当前 Shell 正确加载。不是写对了就行，路径错一位、拼接方式不对、文件没生效，都会导致 command not found。
一、先找到你要指向的真实路径
别凭印象或文档瞎写。比如装了 JDK，别直接写 /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home ——版本号一换就失效。用系统命令动态查：
-
/usr/libexec/java_home -v 17→ 返回 JDK 17 的真实 JAVA_HOME 路径 -
which brew或brew --prefix→ 看 Homebrew 实际装在哪（/opt/homebrew还是~/Develop/Tools/Homebrew） -
find /usr -name "mvn" 2>/dev/null→ 找 Maven 的 bin 文件位置
拿到路径后，只取到 bin 目录的上一级（如 $JAVA_HOME/bin），不要多也不要少。
二、PATH 拼接必须规范
PATH 是冒号分隔的目录列表，Shell 按顺序从左到右找命令。错误写法会覆盖原有路径，导致 ls、cd 都失效：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- ❌ 错误：
export PATH="/opt/homebrew/bin"（清空了系统默认路径） - ✅ 正确：
export PATH="/opt/homebrew/bin:$PATH"（加在最前，优先匹配） - ✅ 更稳妥：
export PATH="$PATH:/opt/homebrew/bin"（加在最后，避免覆盖系统命令）
如果你装了多个工具（JDK、Maven、Homebrew），按优先级顺序拼接，比如开发常用新版 Java，就把 $JAVA_HOME/bin 放最前面。
三、写对配置文件并让它真正生效
Mac 默认用 zsh，99% 的情况只改 ~/.zshrc 就够了。但要注意：
- 用
echo $SHELL确认是/bin/zsh还是/bin/bash，别搞混文件名 - 编辑
~/.zshrc，在末尾添加export PATH=...行，保存后必须运行source ~/.zshrc - 新开终端窗口不会自动重载，必须手动
source；GUI 应用（VS Code、IntelliJ）不读.zshrc，需额外用launchctl setenv或设为登录 Shell 启动
验证是否成功：运行 echo $PATH 看输出里有没有你加的路径，再试 which 命令名（如 which java）看是否指向你预期的位置。
