Homebrew（簡稱 brew）是 macOS 缺失的套件管理器，讓命令列工具、開發函式庫、GUI 應用程式安裝更新如 Linux 般簡單。本文涵蓋安裝、核心指令、進階用法與國內加速配置。

一、安裝 Homebrew

# 官方安裝指令（需網路連線 GitHub）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

國內網路加速：若官方腳本下載緩慢/失敗，可使用中科大/清華鏡像安裝腳本：

# 中科大鏡像
/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"

# 清華鏡像
/bin/bash -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git)"

安裝過程會提示輸入管理員密碼，並自動配置 PATH（Apple Silicon Mac 需手動執行 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile）。

二、核心指令速查表

指令	功能	範例
brew install <formula>	安裝套件	brew install git wget node
brew uninstall <formula>	移除套件	brew uninstall wget
brew search <keyword>	搜尋套件	brew search python、brew search /^python@/ (正則)
brew list	列出已安裝套件	brew list --versions 顯示版本
brew update	更新本地套件索引	建議每日執行一次
brew upgrade	升級所有可更新套件	brew upgrade git 指定升級
brew info <formula>	顯示套件詳細資訊	版本、相依、安裝路徑、選項
brew deps <formula>	顯示相依套件樹	brew deps --installed --tree
brew doctor	診斷環境問題	排查路徑衝突、權限、缺失相依
brew cleanup	清理舊版本快取	brew cleanup -n 預覽
brew services	管理背景服務	brew services start mysql、list、stop

三、Cask：安裝 GUI 應用程式

brew install --cask visual-studio-code google-chrome iterm2 docker
brew list --cask
brew uninstall --cask google-chrome

Cask 讓圖形介面應用也能像套件一樣管理，支援自動更新。

四、鏡像源加速（國內用戶必做）

# 替換 Homebrew 核心倉庫鏡像
cd "$(brew --repo)"
git remote set-url origin https://mirrors.ustc.edu.cn/brew.git

# 替換 Homebrew Core 鏡像
cd "$(brew --repo homebrew/core)"
git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

# 替換 Cask 鏡像
cd "$(brew --repo homebrew/cask)"
git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git

# 設定 Bottles (預編譯二進制) 鏡像
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zprofile
source ~/.zprofile

亦可使用清華、阿里雲、北京外國語大學等鏡像，將 ustc.edu.cn 替換對應域名。

五、常見問題

• brew: command not found：PATH 未生效，重開終端機或手動 eval "$(/opt/homebrew/bin/brew shellenv)" (Apple Silicon) / eval "$(/usr/local/bin/brew shellenv)" (Intel)。
• 權限錯誤：sudo chown -R $(whoami) $(brew --prefix)/*。
• 安裝卡住：brew update --force 強制同步索引。

Homebrew 讓 macOS 開發環境建置自動化、可複現，是開發者必備工具。