Homebrew 是什麼怎麼用：2026 Mac 新手入門
課程要求輸入 brew install，但你只看到一行陌生指令，不知道它會做什麼。
最快解法：Homebrew 是管理 Mac 開發工具的軟體包管理器；課程需要 Git、Python 或 Node.js 時值得安裝，否則可以先使用官方安裝器。按官方方式安裝後，先完成版本、診斷與路徑驗收，再學會一個工具的搜尋、安裝、更新和卸載。
這篇適合第一次打開 Mac Terminal、看不懂 Homebrew、brew 與軟體關係的學生。需要準備 Python、前端或課程專案環境，又擔心輸錯命令的自學者，也可以依時間軸操作。只有 Windows 或學校公共電腦的學習者，則可直接參考文中的遠端環境分支。
Homebrew 是什麼怎麼用：先判斷是否需要
Homebrew 可以想像成「給開發者使用的應用程式商店管理員」。應用程式商店負責尋找和安裝圖形軟體；Homebrew 則讓使用者在 Terminal 以指令管理許多開發工具。brew 是它的指令名稱，不是另一套軟體。
它適合以下情況：
- Python 課程要求額外的命令列工具。
- 前端課程需要 Node.js 或相關工具。
- 專案要使用 Git，且希望日後方便更新。
- 學習者想用同一種方式記錄、重建開發環境。
它不一定適合以下情況：
- 課程已提供官方
.pkg或圖形安裝程式。 - 只使用瀏覽器中的線上編輯器。
- 學校電腦禁止安裝軟體或修改使用者環境。
- 學習者以為安裝 Homebrew 就能在 Windows 原生執行 macOS 軟體。
Homebrew 不是 Xcode，也不會把 Windows 變成 macOS。需要 iOS 開發時，仍要有可執行 macOS 的環境與符合課程要求的 Apple 開發工具。
安裝前的環境分流
正式安裝前，先確認四件事：Mac 的晶片類型、網路是否穩定、目前帳戶是否能輸入管理員密碼，以及 Command Line Tools 是否可用。Homebrew 的實際支援條件與安裝器可能調整，應以官方安裝文件當天的內容為準。
Terminal 是輸入命令的地方。開啟方式可以在 Spotlight 搜尋 Terminal，也可以從「應用程式」中的工具程式資料夾開啟。畫面中的提示符號代表目前輸入位置；游標所在的一行才是要輸入命令的地方。按下 Return 後，下一行通常會顯示執行結果或新的提示符號。
安裝方式與適用情境可以先這樣分：
| 學習情況 | 優先做法 | 原因與限制 |
|---|---|---|
| 課程只給圖形安裝器 | 先用官方安裝器 | 少一層管理工具，較容易依照課程教材對照 |
課程要求 brew install |
按 Homebrew 官方安裝方式 | 後續可集中處理搜尋、更新與卸載 |
| 沒有本機 Mac | 使用具完整權限的真實遠端 Mac | 可練習 Terminal，但要先確認連線、權限與環境是否可重置 |
| 學校電腦禁止安裝 | 不要繞過限制 | 改用獲得授權的個人或遠端環境，避免影響校方設定 |
Homebrew 官方安裝器會在 Terminal 中顯示即將進行的工作。命令應從Homebrew 官方文件提供的安裝方式取得，不要把教學文章中的截圖或陌生縮網址當成來源。
執行安裝命令時，注意以下操作：
- 只複製命令本身，不要把
$、提示文字或下一段說明一起複製。 - 按 Return 後先閱讀畫面內容，不要連續重複執行。
- 若系統要求輸入管理員密碼，Terminal 不會顯示星號，這是正常現象；確認命令來源後再輸入。
- 若畫面顯示要安裝 Command Line Tools，先閱讀用途與容量提示，再依課程需要確認。
- 若出現路徑、權限或網路錯誤，先停止並保留完整輸出，不要自行加上
sudo重試。
安裝完成後的驗收順序
安裝器最後可能要求把 Homebrew 加入 shell 的環境設定。shell 可以理解為 Terminal 背後的「命令解讀員」；PATH 則像地址簿，告訴系統應到哪些位置尋找 brew。只完成檔案安裝、卻沒有完成這一步，常見結果就是輸入 brew 後顯示找不到命令。
Apple Silicon Mac 與 Intel Mac 的預設安裝路徑不同。Homebrew 官方文件列出的典型路徑是 Apple Silicon 使用 /opt/homebrew，Intel 使用 /usr/local；這些路徑及環境設定方式應以官方文件的安裝說明為準。
完成安裝器要求的設定後，關閉並重新開啟 Terminal，依序執行：
brew --version
brew doctor
command -v brew
這三個檢查各自回答不同問題：
brew --version：確認系統能呼叫 Homebrew，並顯示目前版本。brew doctor：檢查常見環境問題。出現建議事項不代表整個安裝必然失敗，應逐項閱讀。command -v brew：確認系統實際找到的是哪一個brew，方便辨認 PATH 是否指向預期路徑。
成功時，第一個命令會顯示版本，第三個命令會回傳路徑。若顯示 command not found，先回看安裝器最後提供的 shell 設定命令，再重新啟動 Terminal。若路徑與晶片類型不一致，不要立即刪除資料夾，應先查閱Homebrew 官方 FAQ。
第一個工具的完整練習
新手不需要一次安裝十多個工具。先用一個可以快速確認、日後也容易移除的命令列工具完成閉環。以下以 tree 作為示範；它的用途是把資料夾結構以樹狀文字列出，適合用來熟悉搜尋、查看、安裝與卸載。
先搜尋，再查看資料：
brew search tree
brew info tree
brew search 用來尋找名稱，brew info 用來查看來源、版本與安裝資訊。確認搜尋結果中的項目就是課程需要的工具後，再執行：
brew install tree
tree --version
若第二個命令能顯示版本資訊，代表工具已經能被 Terminal 找到。接著進入一個測試資料夾，執行：
tree
若只想查看指定資料夾，可把路徑放在命令後方。新手應先在測試資料夾操作，不要一開始就對課程專案執行陌生參數。
| Homebrew 物件 | 新手理解方式 | 常見操作 | 適合的學習場景 |
|---|---|---|---|
| formula | 可在 Terminal 呼叫的工具配方 | brew install 名稱 |
Git、編譯工具、命令列工具 |
| cask | 以 Homebrew 管理的圖形軟體項目 | brew install --cask 名稱 |
某些桌面應用程式 |
| 已安裝項目 | Homebrew 已記錄的工具 | brew list |
核對課程環境與整理清單 |
不是所有軟體都應該透過 Homebrew 安裝。需要圖形介面、授權登入或特殊安裝步驟的工具，先看開發者官方說明。不要因為看到網路文章列出第三方 tap，就直接貼上整段腳本；入門階段先使用 Homebrew 既有來源即可。
第一週的管理習慣
記住以下幾組命令已足夠應付第一週的基本練習。每次執行前，都先看清楚命令後面的名稱。
brew update
brew upgrade
brew list
brew uninstall tree
brew update 更新 Homebrew 對套件的資料認識；brew upgrade 嘗試升級已安裝工具；brew list 列出目前管理的項目；brew uninstall tree 移除示範工具。更完整的參數與行為，可查閱brew 官方手冊。
更新前後都應閱讀 Terminal 輸出。特別留意：
- 不要看到權限錯誤就自行加
sudo。 - 不要執行來源不明的一行安裝腳本。
- 不確定某個項目是否被課程使用時，先用
brew info 名稱查資料。 - 卸載前先記錄專案需要的工具與版本來源。
- 在共用或臨時環境中，先確認是否有重置政策，避免把個人密碼放進命令列或純文字檔。
需要換電腦、重設環境或在遠端 Mac 上重做時，可以用 Brewfile 記錄套件。Homebrew 的Brewfile 官方文件說明了如何匯出與重新使用這份清單。對學生而言，它的價值不是一次安裝大量軟體，而是讓下一次環境設定少靠記憶。
按條件選擇練習環境
先不要把「一定要買 Mac」當成 Homebrew 的前提。真正需要判斷的是：課程是否要求 macOS、學習者是否有安裝權限，以及環境是否需要長期保留。
- 若已有本機 Mac，且能輸入管理員密碼：選本機安裝，按照本文完成驗收。
- 若有本機 Mac，但學校課程只提供圖形安裝器：先依課程文件，不必為了 Homebrew 重新安裝所有工具。
- 若使用學校公共電腦，且沒有安裝權限：回退到不修改系統的線上環境，或使用獲授權的遠端 Mac。
- 若只有 Windows，但課程要求 macOS Terminal：選可連線的真實遠端 Mac；不要把 macOS 虛擬機或不明修改方案當成唯一答案。
- 若只想學 Python 基礎，課程也支援 Windows：先用現有電腦開始，等課程確實需要 macOS 專屬工具時再切換。
- 若需要長期固定環境、特殊 USB 裝置或本機圖形效能：租用遠端環境前，先確認它是否符合這些需求。
沒有本機 Mac 的學生，若想照著本文練習，可以先閱讀遠端 Mac 登入與使用說明，確認連線方式與 Terminal 操作位置。若學校網路限制遠端連線，也應先確認校方規範，而不是反覆重試命令。
新手 FAQ
Homebrew 是否會取代 Mac 的 App Store？
不會。App Store 主要處理圖形軟體與 Apple 帳戶流程；Homebrew 面向開發工具與可管理套件。兩者可以並存，選擇哪一個取決於軟體官方提供的安裝方式，以及課程是否要求 brew 指令。
Homebrew 會不會影響 macOS 系統軟體？
Homebrew 通常管理自己的安裝位置，不等於直接替換 macOS 內建元件。但不應因此任意刪除系統資料夾或修改全域設定。遇到權限、PATH 或重複版本問題時，先查官方文件，再處理單一項目。
關閉 Terminal 後，已安裝的工具還能使用嗎？
可以。關閉 Terminal 不會自動卸載已安裝的工具。下次重新開啟 Terminal 後，若 PATH 設定正確，仍可輸入工具名稱呼叫。若新視窗找不到工具，通常要檢查 shell 設定是否成功載入。
Homebrew 安裝要付費嗎？
Homebrew 本身不是以購買授權的方式使用。實際成本可能來自網路流量、需要安裝的第三方軟體授權，或學習者選擇的 Mac 環境。安裝前仍應閱讀各工具的授權條款，不要把「免費使用 Homebrew」理解成所有套件都免費。
卸載 Homebrew 會一起刪掉課程檔案嗎？
不要把 Homebrew 的管理資料夾與課程專案混為一談。卸載某個 formula 或 cask，處理的是該項目；但專案可能仍保留設定檔、虛擬環境或下載資料。移除前先查看項目內容並備份需要的程式碼，避免把環境清理誤當成專案備份。
從可驗收到可重做的入門標準
Homebrew 的入門驗收不在於記住很多命令，而在於完成一個可重做的流程：能在 Terminal 找到 brew，能安裝一個測試工具，能從命令列呼叫它，也能用 brew uninstall 移除它。完成這四件事後，再把同樣方法延伸到 Python、Git 或前端課程要求的工具。
若目前方案是學校公共電腦或 Windows 加上零散的替代環境，常見限制是沒有管理員權限、無法保留設定，以及 macOS 專屬工具不能直接執行。長期來看，這些限制會讓每次上課都重新排查環境。若只是想先完成一門課、測試 Homebrew 或練習 macOS Terminal，透過 ProxyMac 租用具完整權限的真實遠端 Mac，通常比立刻購買設備更容易控制成本與使用時間；開始前可先查看ProxyMac 的方案資訊，再按課程週期和實際權限需求決定是否適合。
