核心是统一用 ~/.zprofile 管理 path、清除 /etc/paths.d/ 及 /usr/local/bin 残留、区分终端与 gui 加载逻辑，避免多源覆盖导致顺序错乱或路径清空。

mac 上 zsh 覆盖系统 path 的问题，核心不是“path 没设”，而是多个配置源（比如 ~/.zshrc、~/.zprofile、/etc/paths.d/、gui 应用加载逻辑）反复修改同一变量，导致路径被清空、顺序错乱或旧路径残留。解决的关键是：**只在一个地方写 path，清理所有干扰项，分清终端和图形界面的加载差异**。

只用 ~/.zprofile 管理 PATH（登录 shell 入口）

macOS 默认 zsh 启动时，新开终端窗口（非标签页）、Finder 启动 Terminal、VS Code GUI 启动的终端，都优先读 ~/.zprofile。它是真正的登录 shell 入口，适合放所有环境变量和 PATH 设置。

• 把所有 export PATH=... 语句（Homebrew、nvm、Java、Python、Ruby 等）统一移到 ~/.zprofile 开头
• 确保写法是 export PATH="/new/path:$PATH"，而不是 export PATH="/new/path"（后者会清空系统默认路径）
• ~/.zshrc 只保留 alias、prompt、函数等交互式设置，不要放 PATH 相关内容
• 删掉 ~/.bash_profile 或 ~/.bashrc 中的 PATH 行——zsh 不读它们，留着反而容易误改

清理系统级和残留路径干扰

很多“PATH 突然变短”或“git 找不到”的情况，其实是系统或第三方工具偷偷往 PATH 里塞了错误路径，或者手动安装残留覆盖了关键目录。

• 运行 echo $PATH | tr ':' '\n' | sort | uniq -d 查重复项
• 检查并删除 /etc/paths.d/ 下的非必要文件（如 GitHub Desktop、Android Studio 自动添加的条目）
• 删掉 /usr/local/bin 下的手动安装残留：sudo rm -f /usr/local/bin/{node,npm,npx,python3,pip3}
• Apple Silicon 用户确认 Homebrew 路径是 /opt/homebrew/bin，Intel 是 /usr/local/bin，别写反

区分终端与 GUI 应用的环境加载

Terminal 里的命令能用，但 VS Code 或 IntelliJ 里执行脚本却报 command not found？这是因为 GUI 应用不走 shell 登录流程，不会自动加载 ~/.zprofile。

• 给 GUI 应用补环境，推荐用 EnvPane 可视化管理，它会自动注入到所有 macOS 图形界面进程
• 不用第三方工具的话，可在 ~/.zprofile 末尾加一句：launchctl setenv PATH "$PATH"（需配合重启 Dock 或执行 killall Dock）
• 避免在 ~/.zshrc 里 export PATH——它只在新标签页生效，且 GUI 应用完全不读

快速验证和临时恢复

如果 PATH 已崩，连 ls 都找不到，先保底让终端可用，再逐步修复。

• 临时恢复基础路径：export PATH="/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin"
• 验证是否恢复：which ls、which git 应返回路径
• 重装 Xcode 命令行工具（常因系统升级失效）：xcode-select --install
• 改完 ~/.zprofile 后，新开终端窗口验证，不要只靠 source——因为 GUI 终端未必重读