mac用户需先安装xcode命令行工具（xcode-select --install），再通过国内镜像脚本或官方脚本安装homebrew，apple silicon用户须执行eval "$(/opt/homebrew/bin/brew shellenv)"并写入~/.zshrc，最后用brew --version和brew doctor验证成功。
Mac用户需要在终端中快速安装Homebrew这一核心开发工具，但常因Xcode命令行工具缺失、网络不稳定或Apple Silicon芯片路径配置错误导致安装中断或命令不可用。
先装Xcode命令行工具
Homebrew依赖编译环境和系统头文件，不装这个，后续所有brew命令都会报错或卡死在依赖检查阶段。
打开终端，输入：xcode-select --install，回车后弹出窗口点“安装”，等进度条走完。
装完立刻验证：输入 xcode-select -p，终端必须返回 /Library/Developer/CommandLineTools。如果显示其他路径或报错，运行 sudo xcode-select --reset 重置一次。
选一种方式装Homebrew
根据你的网络状况和芯片类型选最稳的路径，别硬扛官方源——尤其在国内多数家庭宽带环境下，raw.githubusercontent.com 直连失败率超70%。
方法一：国内镜像一键安装（推荐95%用户）
复制粘贴这行命令到终端并回车：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
脚本启动后会出现中文菜单，输入 1 选中科大源（响应快、无断连），再按回车；提示输密码时直接键入开机密码（屏幕不显示字符，输完回车即可）。
安装结束时，终端会明确提示类似 ==> 成功!请运行以下命令以生效: eval "$(/opt/homebrew/bin/brew shellenv)" ——【立刻复制这整行并回车执行】，否则新开终端仍找不到brew命令。
方法二：官方脚本安装（仅限网络通畅且用GitHub稳定的用户）
在终端中执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
脚本会自动识别M系列或Intel芯片，并建议默认安装路径。按回车确认；需要密码时输入开机密码（同样不显示），等终端出现 Installation successful! 即可。
Apple Silicon（M1/M2/M3）用户注意：【安装后必须手动加载环境变量】，否则brew命令无效。执行：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc
验证是否真正可用
关闭当前终端，重新打开一个新终端窗口。
输入：brew --version，回车。
看到类似 Homebrew 4.3.0 的输出，说明已就绪。
再输入：brew doctor，回车。
终端显示 Your system is ready to brew.，安装完成。
