Homebrew 官方安裝文件同時說明 macOS 安裝條件與安裝後的 shell 設定;因此,Homebrew 遠端 Mac 安裝可以照官方流程完成,但必須先確認系統與帳戶權限。安裝後依安裝器提示設定終端,再檢查 brew 是否可用。是否要準備開發工具,則要看課程套件會使用預編譯版本,還是需要從原始碼建置;不必預設安裝完整 Xcode。
第一次透過遠端桌面使用 Mac、要替課程準備開發工具的學生,可以按下方步驟操作。
已安裝 Homebrew、只是終端找不到 brew 的讀者,請改看專門的[路徑排查指南]。
使用學校或受管理設備者,應先確認安裝權限,不要嘗試繞過管理政策。
[ SECTION_01 ] Homebrew 遠端 Mac 安裝前,先確認三件事
Homebrew 可以想成課程工具箱的管理員:它協助安裝及管理開發工具,但不會自動替每門課判斷需要什麼,也不等於已安裝所有課程軟體。開始前,先確認正在操作的終端確實連到遠端 Mac。
如果主要使用 Windows,請從遠端桌面或已配置的連線方式開啟 Mac 的終端。不要在 Windows 的命令提示字元或 PowerShell 貼上 Mac 安裝指令。檢查視窗所在的系統與主機,避免把命令送到本機。
| 安裝前檢查 | 確認方式 | 未確認時的處理 |
|---|---|---|
| 目前操作的是遠端 Mac | 從遠端 Mac 開啟終端,確認不是 Windows 本機的命令列 | 先確認遠端桌面或 SSH 連線狀態 |
| macOS 與硬體符合條件 | 依官方安裝文件的最新要求核對,不沿用舊文章的版本資訊 | 不符合或看不懂提示時,暫停安裝並確認環境 |
| 帳戶允許安裝 | 確認裝置管理規則,以及目前帳戶能執行的操作 | 遇到權限限制時聯絡管理者,不嘗試繞過限制 |
Homebrew 的系統支援條件可能隨官方文件更新。安裝前應以當下文件為準,而不是把網路舊教學中的 macOS 版本或安裝路徑當成保證。
| 使用情境 | 自行安裝的適合度 | 主要判斷 |
|---|---|---|
| 個人使用且有安裝權限的遠端 Mac | ◎ | 先核對官方系統要求,再照安裝器提示操作 |
| 學校管理的 Mac,權限尚未確認 | △ | 先詢問管理者;不能因為有終端就認定可自行安裝 |
| Windows 本機終端 | × | 它不是遠端 Mac 的終端,不能直接代替 Mac 執行安裝 |
這裡的評分是操作情境的判斷,不是 Homebrew 對某台主機的相容性承諾。受管理設備有特別的處理注意事項;Homebrew 管理員文件不能解讀成使用者可以自行略過學校政策。
[ SECTION_02 ] 第二步:先判斷課程要用哪類開發工具
安裝 Homebrew 與安裝開發工具是兩件事。先對照課程要求,再決定是否需要安裝工具,不要因為看到 Homebrew 就先下載一整套開發環境。
| 課程工具的安裝情況 | 可能需要的準備 | 對新手的決策 |
|---|---|---|
| 有可用的預編譯套件(bottle) | 依套件與環境條件而定,通常可直接取得預編譯版本 | 先查課程指定套件,勿假設每個套件都能直接使用 |
| 需要從原始碼建置 | 可能需要 Xcode Command Line Tools 或其他開發工具 | 查套件文件及官方支援條件,再準備相符工具 |
| 課程要求 Xcode 圖形介面或 iOS App 開發 | 依課程任務判斷是否需要完整 Xcode | Homebrew 本身不是 Xcode,也不會取代 Xcode |
Homebrew 說明了預編譯套件的用途,而支援層級文件也區分套件建置與開發工具條件。這表示安裝前要先查「課程指定的套件如何取得」,而不是把完整 Xcode 當成所有安裝情境的共同前提。若課程只需要能直接安裝的套件,要求可能不同於自行編譯的情況。
提醒:Xcode Command Line Tools 與完整 Xcode 並非同一套安裝內容。若安裝器或套件提示缺少工具,先核對官方文件和課程要求,再決定要安裝哪一項;不要為了消除提示就盲目下載完整 Xcode。
[ SECTION_03 ] 第三步:從官方入口啟動安裝
從Homebrew 官方安裝入口前往當前安裝說明,閱讀安裝器會執行的操作,再依頁面提供的最新方式,在遠端 Mac 的終端進行安裝。不要從搜尋結果、論壇貼文或不明網站複製腳本,也不要照抄多年以前保存的指令。
終端指令會在目前連線的主機上執行。開始前再核對一次終端屬於遠端 Mac,並確認這台設備允許安裝軟體。若安裝提示涉及權限、裝置管理或系統相容問題,先停下來核對;不能以換用其他命令或帳戶的方式繞過管理政策。
安裝過程若要求確認或顯示將要執行的操作,先閱讀提示再繼續。遇到與官方說明不一致的內容,不要猜著按下確認;保留提示訊息,向設備管理者或課程負責人查證。
[ SECTION_04 ] 第四步:依安裝器提示設定 Mac 終端
安裝完成不一定代表終端已能直接找到 Homebrew。安裝器可能會要求把 Homebrew 加入 shell 設定。Shell 可以理解為終端用來讀取和執行命令的環境;設定不完整時,可能出現安裝已完成但命令無法使用的情況。
依目前安裝器對這台 Mac 顯示的提示操作。不要把舊教學中的路徑和設定指令直接貼上,因為處理方式可能受晶片、安裝位置與使用的 shell 影響。Homebrew 的命令參考文件說明了 shell 環境設定方式;應以官方文件及安裝器針對當前環境給出的內容為準。
完成設定後,重新開啟終端,或依安裝器指示讓目前的 shell 讀取新設定。接著再做驗收。若學校設備不允許修改相關設定,就先詢問管理者,不要自行變更受管設定。
[ SECTION_05 ] 第五步:驗證 Homebrew,再開始課程練習
驗收時,先確認命令可執行,再確認終端看到的環境與預期一致。以下是三個不同目的的檢查例子;指令用法可參考官方命令參考與查詢命令說明。
| 檢查目的 | 可用指令 | 能確認什麼 |
|---|---|---|
| 查看 Homebrew 版本 | brew --version |
終端能執行 brew,並回報版本資訊 |
| 檢視 Homebrew 設定 | brew config |
查看 Homebrew 辨識到的環境資訊 |
| 查看已安裝的公式 | brew list --formula |
確認目前 Homebrew 管理的公式清單 |
這些檢查通過,代表命令可用或能讀取相應資訊;不代表所有課程軟體都已安裝,也不保證每個套件都適用目前系統。如果只遇到「找不到 brew」的訊息,先不要反覆重裝,請改看[Homebrew 路徑排查指南]。
之後按課程清單逐項確認工具名稱、官方來源及安裝需求。先裝一項課程確實會用到的工具,再依該工具的文件完成下一步;避免為了「看起來齊全」批次安裝一整套套件。如果課程需要圖形介面、指定版本或學校核准的工具,還要確認遠端環境符合這些要求。
[ SECTION_06 ] 完成安裝後,按課程需求選擇 Mac 環境
若課程只使用可在目前作業系統執行的工具,沒有必要為了 Homebrew 本身租用遠端 Mac。若課程要求 macOS、Xcode 圖形介面,或必須在 Mac 上完成驗收,Windows 本機則無法直接提供相同的 macOS 操作環境。
自行購買 Mac 適合長期使用、需要本機操作或實體連接埠的情況;遠端 Mac 則適合短期課程、先驗證學習流程,或手邊只有 Windows 電腦的學生。選擇前仍要確認連線方式、可用環境與課程要求。關於遠端 Mac 的使用選項,可先查看 NOVAKVM 的 Mac 環境資訊。
對只想完成一段課程或測試 macOS 工具的學生來說,臨時環境可避免先購置整台 Mac,但遠端操作會依賴網路連線,也不適合需要長期穩定重負載或實體介面的工作。若課程確實需要遠端 macOS,可依需求了解 NOVAKVM 的遠端 Mac 方案;若只是首次安裝 Homebrew,則先完成系統、權限與命令驗收,再決定是否需要額外環境。