在 macOS 上遇到 brew: command not found 错误，通常是因为 ‌Homebrew 未安装‌ 或 ‌PATH 环境变量未正确配置‌

在 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 命令应能正常使用。若仍有问题，可结合具体错误信息进一步排查。