Homebrew安装失败需依次检查Xcode命令行工具、使用官方脚本安装、切换国内镜像源、手动指定路径或修复PATH变量；默认路径为/opt/homebrew（M系列）或/usr/local（Intel），安装后须执行source ~/.zshrc加载配置。
如果您尝试在 macOS 系统中安装 Homebrew 包管理器，但终端提示命令未找到或安装中途失败，则可能是由于 Xcode 命令行工具缺失、网络连接受限或环境变量未正确配置。以下是解决此问题的步骤：
一、安装并验证 Xcode 命令行工具
Xcode 命令行工具为 Homebrew 编译依赖包提供必要支持，缺失将导致 brew install 失败或部分公式（formula）无法构建。
1、打开终端应用，执行命令：xcode-select --install。
2、在弹出窗口中点击“安装”，等待进度条完成并点击“完成”。
3、执行 xcode-select -p 验证路径，正常输出应为 /Library/Developer/CommandLineTools。
二、使用官方脚本一键安装（推荐标准方式）
该方法由 Homebrew 官方维护，自动适配 Apple Silicon（M1/M2/M3）与 Intel 架构，并将 brew 安装至标准路径（/opt/homebrew 或 /usr/local）。
1、在终端中粘贴并执行以下命令：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、按回车确认安装路径（默认为 /opt/homebrew）；若提示输入密码，输入当前用户管理员密码（输入时无可见字符）。
3、安装完成后，终端显示 Next steps: 区块，其中包含需手动执行的 shell 初始化命令，例如：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc。
4、立即加载新配置：source ~/.zshrc（若使用 bash，则执行 source ~/.bash_profile）。
三、使用国内镜像源安装（适用于 GitHub 访问不稳定场景）
当官方脚本因 raw.githubusercontent.com 连接超时或中断失败时，可采用 Gitee 托管的 HomebrewCN 脚本，内置清华、中科大等多源选择，全程中文交互且自动配置环境变量。
1、在终端中执行：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"。
2、出现菜单后，输入数字 2 选择清华大学镜像源（响应快、稳定性高）。
3、按提示输入管理员密码；在后续选项列表中输入 5 执行全自动安装与环境变量配置。
4、安装完成后，终端提示执行 eval "$(/opt/homebrew/bin/brew shellenv)"，请务必立即复制并执行该命令。
四、手动指定路径安装（适用于权限受限或磁盘结构特殊情形）
当系统拒绝写入 /opt/homebrew（如某些企业锁定策略），或需将 Homebrew 安装至用户目录时，可通过 Git 克隆方式控制安装位置与所有权。
1、创建目标安装目录：mkdir -p ~/homebrew。
2、克隆 Homebrew 核心仓库：git clone https://github.com/Homebrew/brew ~/homebrew/brew。
3、将 bin 路径加入 shell 配置：echo 'export HOMEBREW_PREFIX="$HOME/homebrew/brew"' >> ~/.zshrc；再添加：echo 'export PATH="$HOMEBREW_PREFIX/bin:$PATH"' >> ~/.zshrc。
4、重新加载配置：source ~/.zshrc；验证：brew --version 应返回版本号。
五、修复 brew command not found 错误
即使安装成功，终端仍报错 command not found: brew，说明当前 shell 未加载 Homebrew 的可执行路径，需手动注入 PATH 变量。
1、确认芯片架构：uname -m，返回 arm64 表示 M 系列芯片；返回 x86_64 表示 Intel 芯片。
2、根据芯片类型向配置文件写入对应路径： M 系列：echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc； Intel：echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc。
3、执行 source ~/.zshrc（或 source ~/.bash_profile）使更改生效。
