解决 macOS 环境变量覆盖冲突的关键是统一入口（仅用 ~/.zprofile 管理 PATH）、清除冗余路径（删 /etc/paths.d/ 条目及 /usr/local/bin 残留）、区分终端与 GUI 加载逻辑，并用 EnvPane 统一配置 GUI 应用环境。
环境变量覆盖冲突在 macos 开发中很常见，本质不是“变量没设”，而是多个配置源（shell 初始化文件、gui 环境、第三方工具）对同一变量（尤其是 path）反复写入，导致顺序错乱、旧路径残留或新路径被忽略。解决关键在于统一入口、清除冗余、区分终端与 gui 加载逻辑。
统一配置入口：只用 ~/.zprofile 管理 PATH
macOS 默认 shell 是 zsh，但不同启动方式读取不同文件：
- 新开终端窗口（非标签页）、Finder 启动的 Terminal、VS Code GUI 启动的终端 → 读
~/.zprofile - 终端内新建标签页 → 通常复用当前 shell 环境，不重读配置文件
-
~/.zshrc仅用于交互式设置（如 alias、prompt），不应放export PATH=...
把所有 PATH 相关语句（包括 Homebrew、nvm、pyenv、Maven、JAVA_HOME/bin 等）集中移到 ~/.zprofile 开头，并确保顺序合理：
export PATH="/opt/homebrew/bin:$PATH" export PATH="$NVM_DIR/versions/node/v20.15.0/bin:$PATH" export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk-21.0.3.jdk/Contents/Home" export PATH="$JAVA_HOME/bin:$PATH"
清理重复与残留路径
运行 echo $PATH | tr ':' '\n' | sort | uniq -d 可发现重复项；更直接的做法是检查并删掉干扰源：
- 删掉
/etc/paths和/etc/paths.d/下由 IDE 或安装器写入的第三方路径（如 GitHub Desktop、Android Studio 自动添加的条目） - 移除
/usr/local/bin/node、/usr/local/bin/python3等旧手动安装残留：sudo rm -f /usr/local/bin/{node,npm,npx,python3,pip3} - 清空 shell 缓存：
hash -d（Zsh/Bash 均支持）
验证是否真正生效
别信当前标签页，要模拟真实场景：
- 完全退出 Terminal.app，再从 Finder 双击打开 —— 测试 GUI 启动流程
- 在 VS Code 中关闭全部窗口，重新启动，再打开集成终端
- 运行
which node、which java、echo $JAVA_HOME，确认输出符合预期 - 对关键命令补全测试：
node -v && npm -v && mvn -v
用 EnvPane 统一管理 GUI 应用环境
终端能配好，不代表 VS Code、IntelliJ、Postman 等 GUI 工具也能读到相同变量。EnvPane 就是为此设计：
- 安装后在「系统设置 → 通用 → 登录项」里启用 EnvPane Agent
- 在偏好设置面板中直接添加
JAVA_HOME、MAVEN_HOME、PATH等变量，值可引用其他变量（如$JAVA_HOME/bin） - 修改后立即全局生效，无需注销或重启
- 特别适合解决「终端里 java -version 正确，但 IDEA 里提示找不到 JDK」这类问题
