快訊
2026-07-27
macOS 教學

Homebrew 完整安裝教學 2026|macOS 套件管理從零上手

約 5 分鐘閱讀 · 319 次瀏覽

適用系統: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 的 aptyum——讓你用一行指令安裝、更新、移除幾乎任何工具或應用程式,不用再手動到處找安裝包。

更重要的是,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)"

過程中會:

  1. 列出即將執行的操作,等你確認後才繼續
  2. 要求輸入 macOS 登入密碼(輸入時不顯示字元,打完按 Enter 即可)
  3. 若尚未安裝 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@17mysql-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)"' >> ~/.zprofileeval "$(/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 作為替代方案。

廣告