Mac安装Homebrew失败时，应依次执行：一、安装Xcode命令行工具；二、用清华镜像源脚本安装；三、用HomebrewCN脚本全自动安装；四、手动下载PKG包安装；五、验证并配置清华镜像源。
如果您尝试在Mac上安装Homebrew，但终端执行官方脚本失败、提示连接超时或命令未找到，则可能是由于raw.githubusercontent.com访问受限、缺少Xcode命令行工具或环境变量未正确配置。以下是解决此问题的步骤：
一、安装Xcode命令行工具
Homebrew依赖Git和编译工具链，而macOS默认不预装Xcode命令行工具。未安装该工具会导致curl失败、ruby脚本中断或权限错误。
1、打开终端，输入以下命令并回车：
2、系统将弹出图形化安装窗口，点击“安装”并等待完成。
3、安装完毕后，在终端中执行xcode-select -p，若输出/Library/Developer/CommandLineTools则表示已就绪。
二、使用国内镜像源一键安装脚本
绕过GitHub原始地址限制，采用清华、中科大或Gitee镜像源可显著提升下载成功率与速度，避免curl (7) 错误。
1、在终端中执行以下任一命令（推荐清华源）：
/bin/zsh -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git/install.sh)"
2、若提示权限不足，输入当前用户密码继续。
3、安装过程自动完成，无需手动编辑文件或替换URL。
三、通过Gitee镜像脚本全自动安装
该方法由社区维护，集成镜像选择、环境变量写入与源切换，专为国内网络优化，支持M1/M2/M3及Intel芯片自动适配。
1、在终端中运行以下命令：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
2、按提示输入数字“1”选择清华大学镜像源。
3、若系统提示是否删除已有Homebrew，新用户直接按Y回车确认。
4、脚本将自动完成安装、配置~/.zprofile或~/.zshrc，并启用中科大或清华bottles源。
四、手动下载安装包方式
当网络策略严格禁止脚本执行时，可从官网下载离线安装包，规避所有远程连接环节，适用于企业受控环境。
1、访问Homebrew中文官网：https://brew.sh/zh-cn/
2、向下滚动至页面底部，点击“Download the latest release”链接。
3、下载Homebrew-*.pkg格式安装包（如Homebrew-4.4.0.pkg）。
4、双击安装包，按向导完成安装。
5、安装后执行以下命令配置环境变量（根据芯片类型选择其一）：
— Apple Silicon（M系列芯片）：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && eval "$(/opt/homebrew/bin/brew shellenv)"
— Intel芯片：
echo 'eval "$(/usr/local/Homebrew/bin/brew shellenv)"' >> ~/.zprofile && eval "$(/usr/local/Homebrew/bin/brew shellenv)"
五、验证安装并设置国内镜像
安装完成后需验证brew是否可用，并替换核心仓库与二进制瓶（bottles）地址，否则后续brew install仍将缓慢或失败。
1、执行brew -v，若显示版本号（如Homebrew 4.4.0）则安装成功。
2、依次执行以下四条命令配置清华镜像（适用于Apple Silicon与Intel通用）：
git -C /opt/homebrew/bin/brew remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
git -C /opt/homebrew/Homebrew/homebrew-core remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zprofile
source ~/.zprofile
