brew: command not found 错误根源只有两个：Homebrew 未安装，或已安装但 PATH 未包含其路径（M 系列为 /opt/homebrew/bin，Intel 为 /usr/local/bin）；需先用 which brew 判断安装状态，再检查并配置 PATH，最后执行 source ~/.zshrc 生效。
遇到 brew: command not found，别急着重装。这个错误只说明 shell 找不到 brew 这个可执行文件，根源就两个：要么根本没装，要么装了但系统不知道去哪找。
先确认 Homebrew 装没装
在终端里直接运行：
-
which brew—— 如果有输出（比如/opt/homebrew/bin/brew或/usr/local/bin/brew），说明已安装； - 如果完全没反应，就是没装，跳到安装步骤；
- 也可以试试
ls /opt/homebrew/bin/brew（M1/M2/M3/M4）或ls /usr/local/bin/brew（Intel），看文件是否存在。
检查 PATH 里有没有 Homebrew 的路径
Homebrew 安装后不会自动加进系统路径，得手动告诉终端去哪里找它：
- M 系列芯片（Apple Silicon）：路径是
/opt/homebrew/bin； - Intel 芯片：路径是
/usr/local/bin； - 运行
echo $PATH，看看输出里有没有上面对应的路径； - 如果没有，需要把它加进 shell 配置文件（macOS Catalina 及以后默认用
zsh，配置文件是~/.zshrc）。
把路径写进配置并生效
打开终端，依次执行：
- 如果是 M 系列：
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc； - 如果是 Intel：
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc； - 然后运行
source ~/.zshrc让新设置立刻生效； - 再试
brew --version，能打出版本号就成功了。
国内用户特别注意网络和镜像
如果你之前安装失败过，或者卡在 curl: (7) Failed to connect，大概率是 GitHub 原始源连不通：
- 推荐用国内镜像脚本安装：
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"； - 装完立刻切清华源：
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git； - 顺便也换 core 源：
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git。
