核心是统一用 ~/.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 终端未必重读
