小黃老師嘿技術

Mac 安裝 Homebrew 全指南 2025：M1/M2/M3 與 Intel 都適用，PATH／權限／報錯一次解決 2025 最新

此篇主題：Homebrew 安裝、Mac 安裝 Homebrew、brew install、Homebrew PATH、M1 安裝 brew、M2/M3、Intel、Rosetta、brew doctor、brew cask、CotEditor 安裝、權限錯誤、command not found、uninstall Homebrew。

快速版 TL;DR

1. 檢查晶片架構：

   uname -m   # arm64 = Apple Silicon；x86_64 = Intel
   也可以在桌面左上的蘋果符號上按滑鼠的右鍵選『關於這台Mac』直接看
   

2. 安裝指令：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   
   
   圖：安裝好的畫面
   
   
   

3. 設定 PATH（重點！）
   • Apple Silicon（arm64）：

     echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
     eval "$(/opt/homebrew/bin/brew shellenv)"

   • Intel（x86_64）：

     echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
     eval "$(/usr/local/bin/brew shellenv)"

   • 你用 bash 的話，把 ~/.zprofile 改成 ~/.bash_profile。
4. 驗證：

   brew --version
   which brew   # Apple Silicon 會在 /opt/homebrew/bin/brew；Intel 在 /usr/local/bin/brew

5. 實戰（以 CotEditor 為例）：

   brew update
   brew install --cask coteditor
   open -a "CotEditor"

---

Homebrew 是什麼？為什麼 Mac 幾乎必裝？

Homebrew 是 macOS 上最受歡迎的套件管理器（package manager）。它讓你用一行指令安裝各種開發工具（如 git、node、python）與桌面 App（透過 Cask，如 CotEditor、Visual Studio Code、Google Chrome）。有了 Homebrew，你不必到處找 DMG 或 PKG，只要 brew install 就搞定。

安裝位置設計：Apple Silicon 安裝在 /opt/homebrew；Intel 安裝在 /usr/local。這也是為什麼 PATH 設定會因機型不同而不一樣。

安裝前準備（5 分鐘完成）

1. 確認晶片架構：

   uname -m   # arm64 = Apple Silicon；x86_64 = Intel

2. 安裝 Command Line Tools（CLT）： 大多數情況安裝腳本會自動提示，若要手動：

   xcode-select --install

   這會安裝基本編譯工具（例如 clang、git）。
3. （Apple Silicon 選擇性）安裝 Rosetta： 如果你需要執行僅支援 Intel 的舊軟體：

   softwareupdate --install-rosetta --agree-to-license

4. 網路小叮嚀： 安裝過程需連線 GitHub。若公司網路有限制，請改用個人熱點或設定合法 Proxy。

一步到位安裝流程

1. 執行官方安裝指令：

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

2. 依畫面指示輸入密碼（安裝過程會建立目錄與權限）。
3. 完成後，照終端機回傳的提示把 PATH 接起來（下一節有完整範本）。
4. 驗證安裝：

   brew --version
   brew doctor   # 會列出潛在問題與建議修正

設定 PATH（zsh／bash／fish）

macOS 新版預設使用 zsh。建議用 Homebrew 官方提供的 brew shellenv，一條指令解決環境變數。

zsh 使用者（預設殼）

Apple Silicon（M1/M2/M3 / arm64）

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Intel（x86_64）

echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

bash 使用者

把上面指令的 ~/.zprofile 改成 ~/.bash_profile（或 ~/.profile）。

fish 使用者

# Apple Silicon
set -Ua fish_user_paths /opt/homebrew/bin
# Intel
set -Ua fish_user_paths /usr/local/bin
# 或直接：
# echo 'eval (/opt/homebrew/bin/brew shellenv)' >> ~/.config/fish/config.fish

確認 PATH 是否正確

which brew
brew --prefix
brew config | sed -n '1,20p'

Apple Silicon 應看到 /opt/homebrew 前綴，Intel 則是 /usr/local。

基本用法與觀念

• 更新索引： brew update
• 搜尋套件： brew search 名稱
• 安裝 CLI 套件（formula）： brew install git
• 安裝桌面 App（cask）： brew install --cask google-chrome
• 查看資訊： brew info 名稱
• 移除： brew uninstall 名稱（或 --cask）
• 清理舊版本： brew cleanup
• 服務管理： brew services start 名稱／stop／restart

小知識： Cask 安裝的 App 會放在 /Applications（或 ~/Applications），可用 open -a "App 名稱" 啟動。

實戰：用 Homebrew 安裝 CotEditor（含檢查）

1. 更新與安裝：

   brew update
   brew install --cask coteditor

2. 驗證是否已裝：

   brew list --cask | grep -i coteditor

3. 啟動 App：

   open -a "CotEditor"

4. 找安裝位置：

   mdfind "kMDItemCFBundleIdentifier == 'com.coteditor.CotEditor'"

權限與安全：不要亂用 sudo

• Homebrew 設計原則是「非 root」運行。遇到權限錯誤，先跑 brew doctor 看建議。
• 常見修復（謹慎執行）：

  # 把 Homebrew 目錄權限改回目前使用者
  # Apple Silicon
  sudo chown -R $(whoami) /opt/homebrew
  # Intel
  sudo chown -R $(whoami) /usr/local
  

  若你的 Mac 是公司機或受 MDM 管理，請先遵守 IT 政策。
• 不要用 sudo brew install。這會讓後續更新與移除變得困難。

常見錯誤大全與一鍵解法

zsh: command not found: brew

1. 照「設定 PATH」章節把 brew shellenv 加進 ~/.zprofile（或 ~/.bash_profile）。
2. 重新開啟終端機或直接 source ~/.zprofile。

安裝在錯誤前綴（Apple Silicon 卻跑到 /usr/local）

代表你可能在 Rosetta 殼層安裝。建議：卸載錯誤前綴後重裝。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
# 確認 Rosetta 沒啟用後再重裝到 /opt/homebrew

fatal: not in a git directory 或 homebrew-core/tap 損毀

brew update-reset    # 重新對齊遠端倉庫
brew doctor          # 檢查是否仍有問題

Permission denied、Operation not permitted

1. 確定沒用 sudo brew ...。
2. 把前綴目錄調整給目前使用者（見上一章）。
3. macOS 隱私權限制：到「系統設定 → 隱私權與安全性 → 完整磁碟存取」確認終端機工具權限（公司機請循 IT 流程）。

下載超慢／逾時（timeout）／GitHub 429

• 先改用個人熱點測試是否為公司網段問題。
• 使用合法 Proxy；或晚點再試（429 是 API 流量限制）。

brew link 衝突／無法建立符號連結

brew link --overwrite 套件名
# 或先移除舊檔再 link
brew unlink 套件名 && brew link 套件名

同時存在兩套 Homebrew（/opt/homebrew 與 /usr/local）

把你要用的那套路徑排在 PATH 最前面，另一套移除或保留備用：

echo $PATH | tr ':' '\n' | sed -n '1,10p'
which -a brew

CLT / Xcode 相關錯誤

xcode-select --install
sudo xcode-select --switch /Library/Developer/CommandLineTools

Apple Silicon 與 Intel：你必須知道的差異

• 前綴（prefix）： Apple Silicon 用 /opt/homebrew；Intel 用 /usr/local。
• Rosetta： 在 Apple Silicon 用 Rosetta 執行 x86_64 殼層可能把 Homebrew 裝到 Intel 前綴，導致混亂。原則是：能原生就原生。
• 從 Intel 移轉到 Apple Silicon： 新機直接全新安裝到 /opt/homebrew，原機的 brew bundle dump 導出清單，轉到新機 brew bundle 安裝，乾淨俐落。

進階技巧（選讀）

• 一次重裝我的工作環境：

  # 產生安裝清單（在舊機或現有環境）
  brew bundle dump --file=~/Brewfile
  # 在新機：
  brew bundle --file=~/Brewfile

• 外掛倉庫（taps）： 例：字型倉庫

  brew tap homebrew/cask-fonts
  brew install --cask font-jetbrains-mono

• 重置更新狀態：

  brew update-reset

• 停用匿名分析：

  brew analytics off

FAQ

Q1：為什麼我 brew install --cask coteditor 後找不到 App？
多半已裝好，試 open -a "CotEditor" 啟動；或到 Spotlight 搜尋。也可用 brew list --cask 檢查。

Q2：一定要安裝 Xcode 嗎？
不用完整 Xcode，安裝 CLT 即可：xcode-select --install。

Q3：可以把 Homebrew 裝在自訂路徑嗎？
不建議。官方預設前綴最穩定，也最少踩雷。

Q4：怎麼卸載 Homebrew？
用官方卸載腳本：

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

 

Q5：公司電腦裝不起來怎麼辦？
先與 IT 同仁確認政策；必要時使用公司核准的 Proxy 或軟體白名單。

結語

Homebrew 讓 Mac 的軟體管理回歸「用指令解決所有安裝」。只要把 PATH 接好，brew 幾乎是裝了就忘，除了偶爾 brew update && brew upgrade 維護即可。遇到問題，先 brew doctor，多半都能找到方向。本篇也收錄了最常見錯誤與一步解法，照著做就能快速復原。

免責聲明

• 本文提供之指令與設定僅供教學與參考。實作前請先備份個人資料，並依照貴單位 IT 政策執行。
• 權限相關操作（如 chown）具風險，請確認路徑無誤再執行，造成損害請自負風險。
• 本文未與任何第三方廠商建立商業關係；連結如指向外站，請自行辨識安全性。

---

延伸閱讀：Homebrew 官方網站｜Homebrew GitHub