macOS zsh 配置加载顺序取决于 shell 类型：non-login shell（如新终端标签页）只加载 .zshenv 和 .zshrc，login shell 才加载 .zprofile 和 .zlogin；用 ps -p $$ 或 echo $0 判断类型，再按序检查文件内容、PATH 拆解、变量覆盖及 source 实时验证。
排查 macos zsh 配置文件加载顺序冲突，关键不是“找哪个文件写了 path”，而是搞清当前终端实际加载了哪些文件、按什么顺序、哪些内容被覆盖或跳过。新版 mac（catalina 及以后）默认用 zsh，但很多问题源于配置文件误放、重复定义、或启动模式不匹配。
确认当前终端是 login 还是 non-login shell
这是绝大多数“配置不生效”的根源。现代终端（如 Terminal.app、iTerm2）默认以 non-login shell 启动 zsh，因此只加载 .zshenv 和 .zshrc，.zprofile 和 .zlogin 完全不会执行。
- 运行
ps -p $$：如果输出里带-zsh（开头有短横），说明是 login shell；只有zsh则是非登录 shell - 运行
echo $0：返回-zsh表示 login，zsh表示 non-login - 常见误区：把 PATH 写进
.zprofile，却在新标签页里发现没生效——因为新标签页不是 login shell
逐级检查已加载的配置文件内容
不要猜，直接看真实写入的内容。重点检查四个用户级文件（按实际加载顺序）：
-
cat ~/.zshenv：最早加载，工具（如 NVM、Go、PNPM）常自动写入这里，容易导致 PATH 前置混乱 -
cat ~/.zprofile：仅 login shell 加载，适合放开机启动命令（如launchctl load），不适合 PATH -
cat ~/.zshrc：日常主力，99% 的别名、插件、PATH 追加应放这里 -
ls -la ~/.zlogin：基本不用，可忽略，除非你明确需要登录后执行某条命令
特别注意：/etc/zshenv 或 /etc/paths 也可能悄悄注入旧路径（比如残留的 Go 1.18），用 cat /etc/paths 和 cat /etc/zshenv | grep PATH 快速筛查。
验证 PATH 实际构成与来源
环境变量是否生效，不能只看 echo $PATH，要拆解它从哪来、谁在改：
- 运行
echo $PATH | tr ':' '\n'：把 PATH 拆成每行一个路径，方便定位重复或异常路径（如多个/usr/local/bin或旧 Go 路径） - 运行
which python3或which node：确认终端调用的是哪个二进制，再反查它属于哪个 PATH 条目 - 运行
set | grep -E '^(PATH|GOPATH)='：确认变量是否被多次 export，后写的会覆盖前写的 - 临时清空再测试：在终端里手动运行
export PATH="/opt/homebrew/bin:$PATH"，再which brew，能立刻验证路径逻辑
安全重载并观察错误输出
修改后别急着关终端，用 source 触发实时加载，错误信息就是线索：
- 对
.zshrc：运行source ~/.zshrc，注意终端是否报错（如compinit: command not found表明补全模块缺失） - 对
.zprofile：运行source ~/.zprofile，但只在 login shell 下有意义 - 若报错指向某个插件（如
_brew_cask），说明~/.zshrc里启用了该插件，但对应文件损坏或权限不对，可临时注释掉那一行再试 - 想看完整加载过程：运行
zsh -x -i -c exit 2>&1 | head -20，它会模拟一次交互式启动并打印每一步执行的命令
