国内用户安装Homebrew需绕过raw.githubusercontent.com访问限制，可采用镜像源替换、HomebrewCN一键工具、修复权限、跳过卡顿克隆及配置环境变量五种方法。
一、替换为国内镜像源安装脚本
Homebrew 官方安装脚本依赖 raw.githubusercontent.com，该域名在国内常因网络限制导致连接超时或中断。将远程脚本下载至本地并修改其仓库地址为国内镜像，可绕过网络限制并提升安装成功率。
1、在终端中执行命令下载官方安装脚本到当前目录：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
2、使用文本编辑器打开刚生成的 install.sh 文件（如用 nano）：
nano install.sh
3、查找包含 BREW_REPO 的行，通常形如：
#BREW_REPO="https://github.com/Homebrew/brew"
4、将其替换为清华大学镜像源地址：
BREW_REPO="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
5、保存文件并退出编辑器（nano 中按 Ctrl+O 回车保存，Ctrl+X 退出）。
6、赋予脚本执行权限：
chmod +x install.sh
7、运行本地安装脚本：
./install.sh
二、使用 HomebrewCN 一键安装工具
HomebrewCN 是专为国内用户优化的 Homebrew 安装与配置脚本，自动完成镜像源切换、环境变量配置及核心仓库克隆，大幅降低手动操作复杂度。
1、在终端中执行一键安装命令：
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
2、当提示选择镜像源时，输入数字 1 选择中科大源（推荐），或输入 2 选择清华源。
3、根据提示输入开机密码以授权系统级操作。
4、等待脚本自动完成 git 安装（如未预装）、Homebrew 主体安装、homebrew-core / homebrew-cask 克隆及源替换。
5、脚本末尾会提示重启终端，重启后执行 brew --version 验证是否成功。
三、修复 /usr/local/Homebrew 权限问题
若已存在部分 Homebrew 文件但提示“not writable”，说明当前用户对 /usr/local/Homebrew 目录无写入权限，需重置归属权与权限位，否则后续所有 brew 命令均会失败。
1、执行命令修正目录归属权：
sudo chown -R $(whoami) /usr/local/Homebrew
2、确保当前用户拥有写权限：
chmod u+w /usr/local/Homebrew
3、验证修复效果，运行以下命令不应报错：
ls -ld /usr/local/Homebrew
4、检查输出中是否包含 drwxr-xr-x 或类似且用户位含 w 的权限标识。
四、跳过卡顿的 core 克隆阶段并手动初始化
安装过程中常卡在 Cloning into '/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core'，这是因默认从 GitHub 克隆核心配方库所致。可中断该步骤，改用国内镜像手动创建对应目录结构并克隆。
1、当安装过程长时间停滞在 homebrew-core 克隆时，按下 Ctrl+C 强制终止。
2、创建目标目录：
mkdir -p /usr/local/Homebrew/Library/Taps/homebrew
3、进入该目录：
cd /usr/local/Homebrew/Library/Taps/homebrew
4、使用中科大镜像克隆 homebrew-core：
git clone https://mirrors.ustc.edu.cn/homebrew-core.git
5、确认克隆完成且目录结构正确：
ls homebrew-core | head -n 3
五、配置环境变量使 brew 命令全局可用
对于 Apple Silicon（M1/M2/M3）Mac，Homebrew 默认安装路径为 /opt/homebrew/bin；Intel Mac 则为 /usr/local/bin。若终端提示 zsh: command not found: brew，说明 PATH 中未包含该路径。
1、确认 Homebrew 实际安装路径：
echo $(brew --prefix)/bin
2、打开 Zsh 配置文件：
nano ~/.zshrc
3、在文件末尾添加对应 export 行：
export PATH="/opt/homebrew/bin:$PATH"
4、保存并退出（nano 中按 Ctrl+O 回车，Ctrl+X 退出）。
5、立即加载新配置：
source ~/.zshrc
6、验证生效：
which brew
