適用系統:macOS 14 Sonoma 以上(Apple Silicon / Intel 均適用) | 更新日期:2026-04-07
⚡ 站長快讀:核心重點
- 文章屬性:教學實戰
- 難易度 / 耗時:⭐⭐ / 約 15 分鐘
- 核心結論:Homebrew 是 macOS 上最強的套件管理器,一行指令搞定安裝、更新、刪除,從命令列工具到 GUI 應用通吃。裝了它,你才算真正解鎖了 Mac 的開發潛力。
- 適用對象:Mac 新手、剛換 Apple Silicon 的用戶、想系統學會 brew 指令的開發者
🔍 背景說明
你有沒有遇過這種情況:想在 Mac 上裝個工具,官網給你一個 .dmg、拖進 Applications、下次想更新又要重複一遍,想移除還不知道有沒有清乾淨殘留檔案?
這就是為什麼 Mac 用戶需要 Homebrew。
Homebrew 是 macOS(以及 Linux)上最廣泛使用的套件管理器,由開發者 Max Howell 建立,基於 BSD 授權開源。它的定位就像 Linux 的 apt 或 yum——讓你用一行指令安裝、更新、移除幾乎任何工具或應用程式,不用再手動到處找安裝包。
更重要的是,Homebrew 把所有東西裝進自己的目錄(Apple Silicon 用 /opt/homebrew,Intel Mac 用 /usr/local),不會亂動系統原生路徑,移除時也能清得乾乾淨淨。
🛠️ 實戰指南
步驟一:確認系統版本與前置條件
Homebrew 官方目前最佳支援 macOS 14 Sonoma 以上。macOS 10.15 Catalina 到 13 Ventura 屬於「非官方支援但可能還能跑」,10.14 Mojave 以下則完全無法執行,請先升級系統。
另外,Homebrew 需要 Xcode Command Line Tools,執行安裝腳本時會自動提示安裝,也可以提前手動裝好:
bash
# 安裝 Xcode 命令列工具(若系統提示已安裝,直接跳過)
xcode-select --install步驟二:一鍵安裝 Homebrew
打開終端機(Finder → 應用程式 → 工具程式 → 終端機,或 Command + Space 搜尋「終端機」),貼上以下官方安裝指令:
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"過程中會:
- 列出即將執行的操作,等你確認後才繼續
- 要求輸入 macOS 登入密碼(輸入時不顯示字元,打完按 Enter 即可)
- 若尚未安裝 Xcode Command Line Tools,自動觸發安裝流程
💡 為什麼要這樣做? 安裝腳本會自動偵測你的 Mac 是 Apple Silicon 還是 Intel,分別把 Homebrew 裝到對應的目錄,並設好環境變數路徑,不需要你手動判斷。
步驟三:Apple Silicon 用戶補設環境變數
這是 Apple Silicon(M 系列)用戶最常踩的坑。安裝完成後,終端機通常會在最後輸出這兩行提示,務必複製貼上執行:
bash
# 將 Homebrew 路徑寫入 shell 設定檔(Apple Silicon 專用)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"Intel Mac 的安裝腳本通常會自動設好,不需要額外操作。
步驟四:確認安裝成功
bash
# 確認版本號(有輸出即代表安裝成功)
brew --version
# 做一次系統健康檢查
brew doctor如果 brew doctor 回傳 Your system is ready to brew.,恭喜你,全部搞定。
核心指令速查
安裝套件(Formula — 命令列工具)
bash
# 搜尋套件
brew search wget
# 安裝套件
brew install wget
# 安裝指定版本
brew install openjdk@21
# 一次安裝多個
brew install git node python安裝 GUI 應用程式(Cask)
Homebrew Cask 專門用來安裝 macOS 的圖形介面應用程式,會自動下載 .dmg / .pkg 並裝到 /Applications:
bash
# 安裝 GUI 應用(以 VS Code 為例)
brew install --cask visual-studio-code
# 其他常見範例
brew install --cask firefox
brew install --cask rectangle
brew install --cask iterm2更新與維護
bash
# 更新 Homebrew 本身及套件清單
brew update
# 查看哪些套件有新版本
brew outdated
# 升級所有套件
brew upgrade
# 只升級指定套件
brew upgrade wget清理舊版本與快取
安裝新版本時,舊版本不會被立刻刪除,而是保留在 Cellar 備用。記得定期清理:
bash
# 清除所有套件的舊版本和下載快取
brew cleanup
# 先預覽會刪哪些檔(不實際執行)
brew cleanup -n
# 移除不再被任何套件依賴的孤立套件
brew autoremove管理背景服務
bash
# 列出所有服務狀態
brew services list
# 啟動服務(以 mysql 為例)
brew services start mysql
# 停止服務
brew services stop mysql
# 重啟服務
brew services restart mysql移除套件
bash
# 移除套件
brew uninstall wget
# 移除 Cask 應用
brew uninstall --cask firefox💡 站長老實說:進階玩法與底層邏輯
站長我第一次裝 Homebrew 的時候,在 Apple Silicon Mac 上裝完發現怎麼輸入 brew 都說找不到指令,搞了半小時才發現是步驟三的環境變數沒設——這個坑幾乎每個 M 系列新用戶都會踩,請務必注意。
另外分享幾個實用進階技巧:
用 brew bundle 管理你的套件清單
開發者換電腦時最痛苦的就是重裝一堆工具。Homebrew 支援把所有已安裝的套件匯出成一個 Brewfile,換機時一行指令全部還原:
bash
# 把目前所有套件輸出成 Brewfile
brew bundle dump
# 在新電腦上根據 Brewfile 一鍵安裝
brew bundle install強烈建議把 Brewfile 存進 GitHub,跟 dotfiles 一起管理,換機體驗直接起飛。
keg-only 套件的 PATH 問題
有些套件(例如 openjdk@17、mysql-client)安裝後輸入指令會出現 command not found。這是因為它們被標記為 keg-only——Homebrew 刻意不把它們加進全域 PATH,避免和系統版本衝突。遇到這種情況,安裝完成的提示訊息會給你對應的 echo 指令,複製執行就好。
📚 延伸閱讀
❓ 常見問題
Q:裝完之後輸入 brew 顯示「command not found」,我是不是裝失敗了?
A: 99% 是 Apple Silicon 用戶沒有執行步驟三的環境變數設定。重新打開終端機,把 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile 和 eval "$(/opt/homebrew/bin/brew shellenv)" 這兩行貼上執行,再輸入 brew --version 確認即可。
Q:brew install 和 brew install –cask 差在哪?
A: 不加 --cask 安裝的是命令列工具或函式庫(Formula),檔案放在 Homebrew 的 Cellar 目錄裡。加了 --cask 安裝的是有圖形介面的 macOS 應用程式,會裝到 /Applications,跟你平常拖 .dmg 安裝的位置一樣,但移除時更乾淨。
Q:這個方法在舊版 macOS 也適用嗎?
A: macOS 14 Sonoma 以上為官方完整支援。10.15 Catalina 到 13 Ventura 非官方支援,多數功能可用但不保證穩定。10.14 Mojave 以下已完全無法執行 Homebrew,建議升級系統,或改用 MacPorts 作為替代方案。