安裝

關於 Homebrew 受支援安裝的說明，請參閱首頁。

此指令碼會將 Homebrew 安裝到其預設、受支援的最佳前綴 (/opt/homebrew，適用於 Apple Silicon；/usr/local，適用於 macOS Intel；/home/linuxbrew/.linuxbrew，適用於 Linux)，這樣您在 brew install 時，就不需要在 Homebrew 初始安裝後使用 sudo 了。大部分的套件 (二進制套件) 都需要此前綴才能使用。這是一個謹慎的指令碼；即使您已在偏好的前綴中安裝一些東西，您也可以執行它。它會在執行前明確告訴您它將執行的動作。在它開始執行前，您必須確認它將執行的所有動作。

macOS .pkg 安裝程式也會將 Homebrew 安裝到其預設前綴 (/opt/homebrew，適用於 Apple Silicon；/usr/local，適用於 macOS Intel)，原因與上述相同。您可以在 Homebrew/brew 的最新 GitHub 版本中取得。若要指定其他安裝使用者，例如在使用者登入前於登入視窗中安裝套件的情況，請使用 HOMEBREW_PKG_USER 值，將屬性清單檔案寫入 /var/tmp/.homebrew_pkg_user.plist。例如，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，並使用此指令碼設定 HOMEBREW_BREW_GIT_REMOTE 和/或 HOMEBREW_CORE_GIT_REMOTE 於您的 shell 環境中，以 brew update

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 Cloning

您可以透過在安裝期間複製 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 taps 安裝公式和 cask。除非您是 Homebrew 維護人員或貢獻者，否則您可能不應全局啟用此設定。如果需要，可以在安裝後輕鬆啟用它。

無人值守安裝

如果您想要一個非互動的 Homebrew 安裝程式執行，不會提示輸入密碼（例如在自動化腳本中），請在安裝指令前加上 NONINTERACTIVE=1。

替代安裝

Linux 或 Windows 10 子系統 for Linux

查看 Linux 安裝文件上的 Homebrew。

解壓縮到任何位置（不受支援）

技術上，您可以在任何地方解壓縮（或 git clone）Homebrew。但是，您不應安裝在預設、受支援的最佳前置詞之外。許多東西需要在預設前置詞之外從原始碼建置。從原始碼建置速度慢、能源效率低、有錯誤且不受支援。Homebrew 正常運作的主要原因是因為我們使用 bottle（二進位套件），而其中大部分需要使用預設前置詞。如果您決定使用其他前置詞：請勿開啟任何問題，即使您認為它們與您的前置詞選擇無關。它們將會在沒有回應的情況下關閉。

TL;DR：自負風險選擇其他前置詞！

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 的位置時，建置腳本會感到困惑。

多重安裝（不受支援）

在您解壓縮 tarball 的任何地方建立 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 或兩者（視配方而定），才能安裝瓶裝（二進制套件），這是唯一受支援的組態。下載 Xcode 可能需要在較舊版本的 Mac OS X 上擁有 Apple 開發者帳戶。在 Apple 網站免費註冊。

⁴ 在 brew.sh 上找到的一行安裝方法使用位於 /bin/bash 的 Bourne-again shell。特別注意，zsh、fish、tcsh 和 csh 將無法使用。

Homebrew 文件

安裝