Homebrew 可通过三种方式安装:一、官方一键脚本(需先装 Xcode 命令行工具);二、手动指定路径(适配 Apple Silicon,需创建目录、设权限、克隆仓库并配置 PATH);三、使用清华镜像源加速(替换 GitHub 地址并配置远程源)。

如果您在 macOS 系统中需要高效管理命令行工具和开源软件,但尚未安装 Homebrew 这一主流终端包管理器,则可能是由于缺少 Xcode 命令行工具依赖或网络环境限制导致安装失败。以下是多种可行的安装方法:
一、通过官方一键脚本安装(推荐)
此方法使用 Homebrew 官方维护的安装脚本,自动检测系统环境并完成完整部署,适用于大多数标准 macOS 版本(12.0 及以上)。
1、打开“终端”应用(可通过 Spotlight 搜索 Terminal 或在“应用程序 > 实用工具”中找到)。
2、执行以下命令以确保已安装 Xcode 命令行工具:
xcode-select --install
3、在弹出窗口中点击“安装”,等待完成;若提示“command line tools are already installed”,则跳过此步。
4、粘贴并运行官方安装命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
5、按回车确认安装路径(默认为 /opt/homebrew),输入系统密码(输入时无显示,属正常现象)。
二、手动指定安装路径安装(适配 Apple Silicon Mac)
对于搭载 M1/M2/M3 芯片的 Mac,默认安装路径为 /opt/homebrew;若因权限或磁盘结构原因需自定义路径,可采用手动方式控制安装位置与权限配置。
1、创建目标安装目录:
sudo mkdir -p /opt/homebrew
2、将目录所有权设为当前用户:
sudo chown -R $(whoami) /opt/homebrew
3、克隆 Homebrew 核心仓库到该路径:
git clone https://github.com/Homebrew/brew /opt/homebrew
4、将 Homebrew 的 bin 目录加入 PATH:编辑 ~/.zshrc 文件,添加以下行:
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
5、重新加载 shell 配置:
source ~/.zshrc
三、使用国内镜像源加速安装(解决 GitHub 访问超时)
当官方脚本因网络延迟或连接中断失败时,可改用由清华大学、中科大等高校维护的镜像源,显著提升下载成功率与速度。
1、临时配置 Git 使用 HTTPS 代理(如已配置可跳过):
git config --global url."https://mirrors.tuna.tsinghua.edu.cn/git/".insteadOf https://github.com/
2、下载并修改安装脚本本地副本:
curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git/install.sh -o brew-install.sh
3、编辑 brew-install.sh 文件,将所有出现的 github.com 替换为 mirrors.tuna.tsinghua.edu.cn/git/homebrew
4、赋予执行权限并运行:
chmod +x brew-install.sh
./brew-install.sh
5、安装完成后,立即配置 Homebrew 使用清华镜像源:
git -C $(brew --repo) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git










