在 macOS 上遇到 brew: command not found 错误，通常是因为 Homebrew 未安装 或 PATH 环境变量未正确配置。以下是系统化的解决步骤：
1. 确认系统环境
先在终端执行以下命令，了解当前环境：
uname -m # 检查架构：arm64（Apple Silicon）或 x86_64（Intel）
echo $SHELL # 检查默认 Shell（macOS Catalina 及以后默认为 zsh）
echo $PATH # 查看当前 PATH 是否包含 Homebrew路径
- Apple Silicon（M1/M2/M3） ：Homebrew 默认安装路径为
/opt/homebrew/bin - Intel 芯片 ：Homebrew 默认路径为
/usr/local/bin
**2. 安装 Homebrew（若未安装）**
推荐使用官方安装脚本（国内网络较慢时可使用镜像源）：
**国内加速安装（推荐使用）**
使用 Gitee 镜像源，更稳定：
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"安装过程中选择镜像源（如阿里云、清华源等），按提示输入密码完成安装。
安装完成后，脚本通常会自动提示配置 PATH。若未提示，请继续下一步手动配置。
3. 配置 PATH 环境变量
根据你的芯片类型和 Shell，添加对应路径到配置文件：
-
**Apple Silicon（M1/M2/M3） + zsh（默认）**：
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc source ~/.zshrc -
Intel 芯片 + zsh：
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
若使用的是
bash（较少见），应编辑~/.bash_profile而非~/.zshrc。
4. 验证安装是否成功
brew --version若显示版本号（如 Homebrew 4.2.1），说明安装成功！
还可运行以下命令进一步验证：
brew doctor # 检查环境健康状况 brew install wget # 测试安装功能5. 常见问题排查
-
仍提示找不到命令？
确保执行了
source ~/.zshrc或重启终端。 -
权限错误？
避免使用
sudo brew，Homebrew 设计为无需 root 权限运行。若目录权限异常，可修复：sudo chown -R $(whoami) /opt/homebrew/* # M1/M2/M3 sudo chown -R $(whoami) /usr/local/* # Intel -
网络问题导致安装失败？
使用国内镜像源（如上述 Gitee 或 USTC 源）可显著提升成功率 10。
辅助工具推荐
如希望可视化操作或在线验证，可使用以下平台（无需本地配置）：
- InsCode 快马：提供在线终端，支持一键部署和命令测试 13。
按上述步骤操作后，brew 命令应能正常使用。若仍有问题，可结合具体错误信息进一步排查。