安装

受支持的 Homebrew 安装说明位于主页上。

该脚本将 Homebrew 安装到其默认、受支持的最佳前缀（Apple Silicon 为 /opt/homebrew，macOS Intel 为 /usr/local，Linux 为 /home/linuxbrew/.linuxbrew），这样您在 brew install 时，在 Homebrew 初始安装后就不需要 sudo 了。大多数瓶（二进制包）都需要此前缀才能使用。这是一个谨慎的脚本；即使您已在首选前缀中安装了内容，也可以运行它。它会在执行操作之前明确告诉您它将执行什么操作。您必须在它开始之前确认它将执行的所有操作。

macOS .pkg 安装程序也会出于与上述相同的原因，将 Homebrew 安装到其默认前缀（Apple Silicon 为 /opt/homebrew，macOS Intel 为 /usr/local）。它可在 Homebrew/brew 的最新 GitHub 版本中获得。要指定备用安装用户（例如在用户登录前在登录窗口安装软件包的情况），请将属性列表文件写入 /var/tmp/.homebrew_pkg_user.plist，其值为 HOMEBREW_PKG_USER。例如，defaults write /var/tmp/.homebrew_pkg_user HOMEBREW_PKG_USER penny。文件和用户必须在安装前存在。

macOS 要求

64 位 Intel CPU 或 Apple Silicon CPU ¹
macOS Monterey (12)（或更高版本）²
适用于 Xcode 的命令行工具 (CLT)（来自 xcode-select --install 或 https://developer.apple.com/download/all/）或 Xcode ³
用于安装的 Bourne-again shell（即 bash）⁴

高级配置

Homebrew 安装程序提供各种高级配置设置。大多数用户可以跳过此部分，转而遵循主页上的说明！

Git 远程镜像

如果您在连接到 GitHub.com 时遇到问题，可以使用 Git 镜像来安装 Homebrew 和 brew update，方法是使用此脚本在您的 shell 环境中设置 HOMEBREW_BREW_GIT_REMOTE 和/或 HOMEBREW_CORE_GIT_REMOTE

export HOMEBREW_BREW_GIT_REMOTE="..."  # put your Git mirror of Homebrew/brew here
export HOMEBREW_CORE_GIT_REMOTE="..."  # put your Git mirror of Homebrew/homebrew-core here
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

如果未设置相应的环境变量，将使用默认的 Git 远程，并且最适合大多数用户。

注意：如果您设置了这些变量，则表示您授予这些存储库与您当前授予 Homebrew 本身的同等信任级别。您应该非常确信这些存储库不会受到损害。

默认 Tap 克隆

您可以通过在安装期间克隆 Homebrew/homebrew-core tap 来指示 Homebrew 返回到 4.0.0 之前的行为，方法是使用以下命令设置 HOMEBREW_NO_INSTALL_FROM_API 环境变量

export HOMEBREW_NO_INSTALL_FROM_API=1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

这将使 Homebrew 使用这些存储库的本地签出，而不是 Homebrew 的 API，从 homebrew/core 和 homebrew/cask tap 安装配方和 cask。除非您是 Homebrew 维护者或贡献者，否则您可能不应该全局启用此设置。如果需要，可以在安装后轻松启用它。

无人值守安装

如果您想要一个不需要密码提示的 Homebrew 安装程序的非交互式运行（例如在自动化脚本中），请在安装命令前加上 NONINTERACTIVE=1。

备选安装

Linux 或 Windows 10 子系统 for Linux

查看 Linux 上的 Homebrew 安装文档。

在任何地方解压（不受支持）

从技术上讲，您可以在任何地方提取（或 git clone）Homebrew。但是，您不应该在默认的、受支持的最佳前缀之外进行安装。许多内容将需要在默认前缀之外从源代码构建。从源代码构建速度慢、能耗低、有缺陷且不受支持。Homebrew 正常工作的最主要原因是因为我们使用瓶子（二进制包），而其中大多数需要使用默认前缀。如果您决定使用其他前缀：不要打开任何问题，即使您认为它们与您的前缀选择无关。它们将被关闭，不会得到回应。

简而言之：选择其他前缀自担风险！

mkdir homebrew && curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C homebrew

或

git clone https://github.com/Homebrew/brew homebrew

然后

eval "$(homebrew/bin/brew shellenv)"
brew update --force --quiet
chmod -R go-w "$(brew --prefix)/share/zsh"

确保避免安装到

名称中包含空格的目录。Homebrew 本身可以处理空格，但许多构建脚本不能。
/tmp 子目录，因为 Homebrew 会发脾气。
/sw 和 /opt/local，因为当 Homebrew 存在于 Fink 或 MacPorts 代替它们时，构建脚本会感到困惑。

多个安装（不受支持）

在您解压 tar 包的任何地方创建 Homebrew 安装。无论调用哪个 brew 命令，都将安装软件包。您可以根据需要使用它，例如在默认前缀中设置系统库集，并在 ~/homebrew 中调整开发公式。

卸载

卸载在常见问题解答中记录。

¹ 有关 32 位或 PPC 支持，请参阅 Tigerbrew。

² macOS 12（Monterey）或更高版本最好且受支持，10.11（El Capitan）– 11（Big Sur）不受支持但可能有效，10.10（Yosemite）及更早版本根本无法运行 Homebrew。对于 10.4（Tiger）– 10.6（Snow Leopard），请参阅 Tigerbrew。

³ 您可能需要安装 Xcode、CLT 或两者，具体取决于公式，以安装瓶子（二进制包），这是唯一受支持的配置。在较旧版本的 Mac OS X 上下载 Xcode 可能需要一个 Apple 开发者帐户。在 Apple 网站上免费注册。

⁴ 在 brew.sh 上找到的一行安装方法使用 /bin/bash 中的 Bourne-again shell。值得注意的是，zsh、fish、tcsh 和 csh 将不起作用。

Homebrew 文档

安装