本质是shell未找到brew可执行文件，需按安装位置→path环境变量→shell配置文件三层顺序排查：先确认brew实际路径（apple silicon为/opt/homebrew/bin，intel为/usr/local/bin），再检查echo $path是否包含该路径，最后核对~/.zshrc等配置文件是否正确写入并source生效。
终端输入 brew 却提示 command not found，本质是 shell 找不到 brew 可执行文件的位置。这不是 homebrew 坏了，而是路径没“告诉”终端。排查要从安装位置、环境变量、shell 配置三层入手，顺序不能乱。
确认 brew 实际装在哪
Homebrew 在 Apple Silicon（M1/M2/M3/M4）上默认装在 /opt/homebrew，Intel Mac 则是 /usr/local。但如果你自定义过路径（比如 ~/Develop/Tools/Homebrew），就得自己找。
- 运行
which brew—— 如果有输出，就是真实路径；如果空白，说明当前 shell 根本没加载它 - 没结果？试试
find / -name brew 2>/dev/null | grep bin，重点看这些位置：/opt/homebrew/bin/brew（Apple Silicon 默认）/usr/local/bin/brew（Intel 默认 或 Rosetta 模式下）~/Develop/Tools/Homebrew/bin/brew（自定义路径常见） - 再补一手：直接运行
/opt/homebrew/bin/brew --version或/usr/local/bin/brew --version，看哪个能成功，就说明它存在且可用
检查 PATH 里有没有这个路径
即使 brew 文件存在，shell 也得知道去哪找它。PATH 就是这个“寻路清单”。
- 运行
echo $PATH，看看输出里是否包含你刚确认的 brew 路径（比如/opt/homebrew/bin） - 如果没有，说明环境变量漏配了。别急着手动加，先看下一步——配置文件有没有生效
- 注意顺序：PATH 中靠前的路径优先匹配。如果
/usr/local/bin和/opt/homebrew/bin都在 PATH 里，但前者排前面，而里面有个旧版或损坏的 brew，也可能导致命令异常
核对 Shell 配置文件是否写对、已加载
macOS Catalina（10.15）起默认用 zsh，老系统或手动改过可能是 bash。配置文件必须匹配，内容也要准确。
- 先确认你用的是什么 shell：
echo $SHELL，大概率是/bin/zsh - 对应配置文件通常是：
zsh →~/.zshrc（最常用）或~/.zprofile
bash →~/.bash_profile或~/.bashrc - 打开对应文件，检查有没有这行（以 Apple Silicon 为例）：
export PATH="/opt/homebrew/bin:$PATH"
或更推荐的官方写法：eval "$(/opt/homebrew/bin/brew shellenv)" - 改完保存后，必须执行
source ~/.zshrc（或对应文件）才生效。只改文件不 source，等于没改 - 小陷阱：有些用户在多个配置文件里重复写了 PATH，还互相覆盖，建议只保留一处，删掉冗余行
验证和兜底操作
做完上面三步，再验证是否真通了。
- 新开一个终端窗口（不是新标签页），再输
brew --version。新开窗口能排除缓存干扰 - 还是不行？运行
brew doctor，它会主动报出权限、路径、配置冲突等典型问题 - 终极兜底：重新安装一次，但务必让安装脚本自动配置环境变量。安装完成后，终端会提示类似：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
这行一定要执行，然后source ~/.zshrc
