Homebrew 官方文件列出的預設安裝前綴，Apple silicon Mac 是 /opt/homebrew，Intel Mac 則是 /usr/local；這表示找不到 brew 時，第一步應核對實際安裝位置與 shell 設定，而不是直接重裝。可先用官方的預設安裝位置說明對照你的 Mac。
症狀：Homebrew 安裝後，終端機顯示找不到 brew。
最快解法：先確認安裝是否完成，再檢查終端機是否載入安裝時提示的 shell 設定；若安裝目錄存在而新終端機仍無法辨識，就按實際前綴修正設定，不要改系統權限。
這篇適合第一次在 Mac 上安裝 Homebrew、需要按順序檢查安裝狀態與指令路徑的學生。
如果你剛從 Windows 轉用 Mac，或使用學校管理的 Mac、遠端 Mac，也可以用以下步驟確認設備限制與課程環境。
安裝完成後的初步判斷
shell 是終端機用來讀取指令與設定的命令解譯器；PATH 則是系統尋找可執行指令的一組路徑。終端機說找不到 brew，代表目前的 shell 沒有在可搜尋的位置找到它，不足以證明 Homebrew 一定沒有安裝。
先保留安裝器最後顯示的內容，以及終端機的完整錯誤訊息。Homebrew 官方安裝流程會在安裝後提示 shell 設定步驟；若這個提示沒有執行或沒有正確完成，安裝可能已完成，但新開的終端機仍認不得指令。詳細流程可對照官方安裝說明與安裝後設定。
先在原本的終端機執行：
command -v brew
brew --version
command -v brew 有回傳路徑，代表目前 shell 找得到這個指令；brew --version 能顯示版本，則表示指令可以啟動。這兩項檢查可搭配Homebrew 指令手冊確認。如果前者沒有輸出，先不要重跑安裝器，繼續核對實際檔案位置。
怎麼確認 Mac 上是否已經安裝 Homebrew？先看安裝器是否完成，以及 brew --version 是否能執行；若指令無法辨識，再檢查安裝前綴內的執行檔。單看「找不到指令」不能判定軟體不存在。
實際安裝位置
安裝前綴是 Homebrew 放置主要檔案的根目錄。官方列出的預設前綴依平台而異，但自訂安裝、舊設定或學校設備管理可能令你的實際位置不同。不要看到某個路徑就假設它適用於所有 Mac。
可先按自己的設備檢查官方預設位置：
test -x /opt/homebrew/bin/brew && echo "找到 Apple silicon 預設位置"
test -x /usr/local/bin/brew && echo "找到 Intel 預設位置"
這些路徑依據 Homebrew 的預設安裝位置文件；檢查結果只表示該位置有可執行檔，不代表它必然是你當初使用的安裝方式。若兩個位置都沒有結果，以安裝器輸出和你實際選用的安裝位置為準。不要為了找檔案而修改其他資料夾權限。
Homebrew 安裝完成後，終端機為何仍找不到 brew？常見原因是執行檔存在，但目前 shell 的 PATH 沒有包含相應位置；另一種情況是安裝尚未完成。把安裝器輸出、檔案位置與 command -v brew 的結果一起比對，才容易分辨兩者。
shell 設定檔核對
先辨認終端機正在使用的 shell。可查看登入 shell：
echo $SHELL
若要查看目前這個終端機工作階段正在執行的 shell，可使用：
ps -p $$ -o comm=
Apple 的終端機預設 shell 說明介紹如何查看及更改預設 shell。你不需要為了修復 Homebrew 而更改預設 shell；這一步只是避免把設定寫進不相符的檔案。
接著回看安裝器提示，確認它要求加入哪個 shell 設定檔，以及實際安裝前綴生成的 shellenv 設定。Homebrew 官方提供按前綴設定 shell 的方式，應以安裝後步驟中的指示為準。若你的前綴與官方預設不同，不要直接複製別人的路徑或指令。
Homebrew 的 shell 設定應檢查哪個檔案？檢查目前使用的 shell 對應設定檔，以及安裝器提示你更新的檔案。不同 shell、不同登入方式可能讀取不同設定；以安裝器輸出和官方說明為準，不要一次修改多份檔案。
只補上安裝器要求的設定，不要覆蓋整份設定檔，也不要執行來源不明的腳本。若 Homebrew 指令可啟動但更新或套件操作出錯，應依照官方排錯說明檢查錯誤內容，而不是將問題一概歸咎於 PATH。
新終端機驗收與分支判斷
完成設定後，關閉目前終端機視窗並重新開啟，再執行：
command -v brew
brew --version
重新開啟的終端機能找到 brew，才表示設定在新工作階段也生效。Apple 的終端機使用指南說明如何使用終端機視窗；不要只以原視窗裡暫時成功的結果驗收。
新開終端機後 brew 仍不能用，應檢查什麼？依序重查目前 shell、設定檔、安裝前綴，以及設定檔中的 shellenv 是否指向實際位置。若機器由學校管理，且你沒有修改設定的權限，先停止，不要嘗試繞過管理限制或要求更高權限。
依條件選擇下一步：
- 若
brew --version正常，繼續課程要求的操作，無須重新安裝。 - 若預設位置找到執行檔，但新終端機找不到指令，回到 shell 設定檔核對前綴與
shellenv。 - 若沒有找到執行檔且安裝器未顯示完成，先按官方安裝說明確認安裝狀態；不要用重複安裝掩蓋原因。
- 若設備限制你修改設定，先詢問管理員，或改用符合課程要求且獲准的環境。
排查對照表
以下三張表把前面的時間順序整理成可直接核對的條件。官方預設路徑只適用於相應安裝情況，不應取代你自己的安裝器記錄。
| 檢查項目 | 結果 | 下一步 |
|---|---|---|
| 安裝器輸出 | 未顯示完成，或有錯誤 | 先按官方安裝步驟確認安裝狀態 |
command -v brew |
有回傳路徑 | 再執行 brew --version 驗證指令 |
command -v brew |
沒有回傳路徑 | 檢查實際安裝前綴和 shell 設定 |
| 新終端機驗收 | 指令仍無法辨識 | 對照 shell 類型、設定檔及 shellenv |
| Mac 類型或情況 | 官方預設前綴參考 | 核對原則 |
|---|---|---|
| Apple silicon Mac | /opt/homebrew |
確認安裝器是否採用此預設位置 |
| Intel Mac | /usr/local |
確認安裝器是否採用此預設位置 |
| 自訂安裝或學校管理設備 | 以實際安裝為準 | 不照抄預設路徑；查看安裝器輸出與管理規則 |
| 條件 | 判斷 | 行動 |
|---|---|---|
執行檔存在，原終端機找不到 brew |
多半是目前 shell 尚未載入正確設定 | 按安裝器提示核對設定檔與前綴 |
| 原終端機可用，新終端機不可用 | 設定未在新工作階段持續生效 | 重查 shell 與設定檔讀取情況 |
| 安裝狀態不明，檔案也未找到 | 不能只靠錯誤訊息斷定原因 | 回看安裝器輸出，再依官方流程處理 |
| 學校政策禁止修改設定 | 屬於設備權限限制 | 停止自行擴大權限，向管理員確認 |
如果你是在學校設備上受限，先確認課程是否允許使用其他 Mac 環境；若需要比較可用選項，可查看 MACCOME 的 Mac 使用方案。遠端環境也應以你實際能否完成終端機操作、課程工具驗收及必要檔案存取為準；你可從 MACCOME 繁體中文頁面了解相關資訊。
單純漏了 shell 設定時，先按官方步驟修復最直接。若你的個人電腦不足以使用 macOS、學校設備限制安裝，或課程要求必須在 Mac 上驗收，租用遠端 Mac 可免去購買實機，但仍要考慮遠端連線、檔案傳輸與使用期間安排；若你需要長期穩定重負載或實體連接埠，自購設備可能更合適。先用課程工具確認所需環境，再判斷是否適合透過 MACCOME 租用 Mac。