1. 一臺Intel Mac把Homebrew裝崩之后我開始找圖形界面1.1 那幾行讓人血壓升高的報錯我手頭有一臺2019年的Intel款MacBook Pro平時跑一些老的自動化腳本環(huán)境一直靠Homebrew維護(hù)。前段時間系統(tǒng)升級了一回終端里敲brew直接變成command not found。重新執(zhí)行官方安裝命令腳本下載階段就卡死好不容易把腳本弄下來裝到一半又提示/usr/local/Homebrew is not writable。當(dāng)時整個人是懵的。Homebrew 在這臺機(jī)器上用了好幾年從來沒出過這種問題。更尷尬的是網(wǎng)上搜了一圈Intel Mac 安裝不了 Homebrew 這個說法居然還挺普遍從論壇到問答社區(qū)都有人在問。問題表現(xiàn)各不相同但底層原因大多就那幾類——架構(gòu)適配、目錄權(quán)限、安裝源下載失敗、舊環(huán)境殘留互相干擾。也正是這次折騰讓我認(rèn)真試了一個叫BrewUI的工具。說實(shí)話之前我一直覺得給 Homebrew 配圖形界面是脫褲子放屁命令行多干凈利落。但當(dāng)你面對一個卸載卸不干凈、重裝裝不上、報錯信息還含含糊糊的爛攤子時圖形面板帶來的狀態(tài)可視化和一鍵操作確實(shí)能省掉不少反復(fù)試錯的成本。1.2 為什么會有Intel Mac 裝不了 Homebrew的說法先把這個說法拆清楚。Homebrew 官方現(xiàn)在的默認(rèn)安裝腳本在新版 macOS 上更傾向于 Apple Silicon 的路徑/opt/homebrew但這個腳本對 Intel Mac 并不是不兼容它依然會走/usr/local。問題出在幾個地方第一安裝腳本下載階段就失敗。官方安裝腳本托管在 GitHub 的 raw 域名下某些網(wǎng)絡(luò)環(huán)境下這個域名的連接非常不穩(wěn)定經(jīng)常下載到一半就斷。很多人連第一步都沒過去自然以為裝不了。第二目錄權(quán)限卡住。/usr/local這個路徑在舊版 macOS 上權(quán)限比較松散但新版系統(tǒng)收緊之后普通用戶默認(rèn)沒有寫權(quán)限。安裝腳本一旦沒檢測到目錄歸屬就會卡在權(quán)限校驗(yàn)。第三上次卸載沒卸干凈。舊版本Homebrew 的殘留文件會在重裝時引發(fā)各種奇怪沖突——最常見的就是提示 git 倉庫狀態(tài)異常、軟鏈接沖突、Cellar目錄損壞。這三類問題疊加在一起就構(gòu)成了Intel Mac 裝不了 Homebrew的主要畫像。實(shí)際上每一個都有確定的解決方案但純靠命令行排查一條條試下來確實(shí)很消磨耐心。2. BrewUI到底是個什么角色它不是替代品而是儀表盤2.1 定位把散落終端的操作集中到一個面板BrewUI從名字就能看出來是給 Homebrew 套的一層圖形界面。它的核心工作原理很簡單底層依然調(diào)用brew命令前端負(fù)責(zé)把命令包裝成按鈕、列表、狀態(tài)面板讓你不用記參數(shù)、不用盯著終端輸出。打個比方Homebrew 本身是一臺功能完整的車你能開但儀表盤、中控屏、倒車影像全是后裝的。BrewUI 就是那個后裝的中控屏——它不改變引擎結(jié)構(gòu)但讓你一眼看到油箱剩多少、水溫多高、哪個輪胎胎壓異常。對普通用戶來說它的價值是降低操作門檻對老手來說它的價值在于把一堆原本靠brew list、brew outdated、brew doctor拼湊出來的狀態(tài)集中到一個頁面上展示。裝了什么包、哪些包有更新、磁盤空間被誰占了打開網(wǎng)頁一目了然。2.2 安裝BrewUI的完整路徑這里有個比較微妙的地方BrewUI 本身是個 Homebrew 生態(tài)里的工具所以正常前提是你已經(jīng)有一個能跑起來的 Homebrew。安裝方式通常有兩種方式一借助 Homebrew 本體安裝brew tap brewui/brewui brew install brewui安裝完以后BrewUI 會提供一個啟動命令。以我用的 Web 版為例brewui serve --port 8080啟動成功后瀏覽器訪問http://localhost:8080就能進(jìn)入管理面板。首次進(jìn)入會要求你設(shè)置或確認(rèn)一個訪問令牌這個令牌的作用是防止局域網(wǎng)內(nèi)其他人直接操作你的包管理環(huán)境別嫌麻煩直接在配置文件里寫死一個強(qiáng)密碼就行。方式二獨(dú)立二進(jìn)制包安裝如果你的 Homebrew 已經(jīng)處于半殘狀態(tài)來不及修復(fù)也可以直接從 BrewUI 的發(fā)布頁下載對應(yīng)架構(gòu)的二進(jìn)制文件。Intel Mac 就下載amd64版本Apple Silicon 就下載arm64版本。下載完放到/usr/local/bin或者~/bin目錄下賦予執(zhí)行權(quán)限就能跑起來。2.3 幾種常見形態(tài)和界面布局BrewUI 目前比較常見的形態(tài)有兩種一種是純本地 Web 服務(wù)瀏覽器操作另一種是桌面客戶端封裝本質(zhì)是同一個內(nèi)核外面套了個 Shell。我個人的建議是用 Web 版。原因很簡單——桌面客戶端多一層打包層版本更新往往滯后而且 Web 版可以直接放到局域網(wǎng)里家里兩臺 Mac 共用一套管理面板服務(wù)器那臺跑brewui serve其他機(jī)器瀏覽器訪問就行。界面布局基本是經(jīng)典的后臺管理風(fēng)格儀表盤顯示已安裝包總數(shù)、Cask 應(yīng)用總數(shù)、可用更新數(shù)量、Homebrew 占用的磁盤空間包管理可分門別類列出 Formula 和 Cask支持搜索、篩選、批量選擇更新隊(duì)列列出所有可升級的包支持勾選跳過某些包依賴圖以樹形或力導(dǎo)向圖展示包之間的依賴關(guān)系日志中心集中展示最近執(zhí)行的 brew 操作輸出方便回溯錯誤3. 裝上BrewUI之前先把手動安裝這關(guān)過了Intel Mac特有的三個坑BrewUI 再方便前提也是 Homebrew 本體能正常工作。所以這里先把我踩過的三個坑完整復(fù)盤一遍每個坑都給出定位思路和解決方案。你會發(fā)現(xiàn)在圖形界面里處理這些問題的前提恰恰是先搞清楚它們在命令行下的表現(xiàn)。3.1 報錯一安裝腳本下載失敗或連接中斷這個坑的癥狀最典型執(zhí)行官方安裝命令以后終端卡在curl: (7) Failed to connect to raw.githubusercontent.com port 443這種位置或者干脆超時。定位思路很簡單安裝腳本本身托管在 GitHub 的 raw 域名下這個域名在某些網(wǎng)絡(luò)環(huán)境下連接質(zhì)量很差。很多教程會推薦你多試幾次或者換個網(wǎng)絡(luò)這在運(yùn)氣好的時候有效但本質(zhì)上沒有解決問題。我的處理方案是兩步走第一步手動下載安裝腳本到本地。curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh -o install.sh如果這一步也失敗那就只能找鏡像站拉取。國內(nèi)幾所高校的鏡像站都有 Homebrew 安裝腳本的同步從鏡像站下載腳本文件然后本地執(zhí)行# 示例從清華 TUNA 鏡像拉取安裝腳本 git clone https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git cd install bash install.sh第二步執(zhí)行時帶上非交互參數(shù)。安裝腳本默認(rèn)會讓你回車確認(rèn)腳本執(zhí)行到一半如果終端會話斷開殘留狀態(tài)會非常難清理。所以建議執(zhí)行前設(shè)置環(huán)境變量export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git export NONINTERACTIVE1 bash install.shNONINTERACTIVE1的作用是跳過交互確認(rèn)腳本全程自動執(zhí)行。設(shè)置HOMEBREW_BREW_GIT_REMOTE和HOMEBREW_CORE_GIT_REMOTE是為了讓安裝腳本直接從鏡像源克隆代碼倉庫而不是去連 GitHub。這一步做好了后續(xù) brew update 的速度也會有質(zhì)的提升。3.2 報錯二/usr/local/Homebrew is not writable這個報錯往往出現(xiàn)在安裝腳本運(yùn)行到一半的時候有時也出現(xiàn)在老版本升級的遷移過程中。核心原因是/usr/local目錄的所有者不是當(dāng)前用戶。舊版 macOS 上/usr/local是系統(tǒng)內(nèi)置目錄Homebrew 安裝時會自動把它調(diào)整為當(dāng)前用戶所有。但新版系統(tǒng)對系統(tǒng)目錄的保護(hù)更嚴(yán)格安裝腳本沒有權(quán)限改屬主于是直接拋錯。解決方案也不復(fù)雜手動把目錄屬主改回來sudo chown -R $(whoami) /usr/local/Homebrew /usr/local/Cellar /usr/local/Caskroom注意這里只改 Homebrew 相關(guān)的子目錄就夠了不要對整個/usr/local執(zhí)行chown -R否則會破壞系統(tǒng)本身的文件權(quán)限結(jié)構(gòu)。如果你不清楚哪些目錄是 Homebrew 創(chuàng)建、哪些是系統(tǒng)原有的最簡單的辦法是先執(zhí)行l(wèi)s -la /usr/local看一眼。Homebrew 通常涉及的目錄包括Homebrew、Cellar、Caskroom、bin、etc、include、lib、opt、sbin、share、var。保險起見只處理前三項(xiàng)加binetclibopt這幾個即可。提示如果你平時用sudo brew這種姿勢那不是 Homebrew 的正確用法。Homebrew 設(shè)計上就要求以普通用戶運(yùn)行所以每次操作都要 sudo 的環(huán)境大概率是目錄權(quán)限壞掉了優(yōu)先修復(fù)權(quán)限而不是給命令加 sudo。3.3 報錯三git倉庫損壞與路徑殘留的偽裝故障這個坑最容易讓人誤判。癥狀看起來是Homebrew 能執(zhí)行但什么都裝不了隨便跑一條命令就報Error: Not a valid ref: refs/remotes/origin/master fatal: ambiguous argument origin/master: unknown revision or path not in the working tree.很多人以為這是 git 版本問題實(shí)際上多半是 Homebrew 的本地倉庫元數(shù)據(jù)損壞或者之前手動刪除文件刪了一半。處理方式是重建倉庫。先進(jìn)入 Homebrew 的安裝目錄把舊的 git 元數(shù)據(jù)備份或清掉cd $(brew --repo) git remote remove origin git remote add origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git git fetch origin git reset --hard origin/master如果brew --repo這步本身報錯說明 Homebrew 命令已經(jīng)不可用那就只能用最原始的方式重裝。注意重裝之前一定要把舊的 Homebrew 目錄改名而不是刪除目錄改名為Homebrew.bak等新環(huán)境跑通了再刪避免數(shù)據(jù)損失。4. 在BrewUI里做完這些高頻操作基本就不太碰命令行Homebrew 的命令行操作本身不難但日常頻率高了以后重復(fù)輸入同樣的命令還是有點(diǎn)煩。BrewUI 對我來說最大的價值就是把下面這幾類高頻操作從敲命令變成了點(diǎn)按鈕。4.1 搜索和安裝比終端少打一半字終端里找包通常是這么個流程brew search 關(guān)鍵詞然后從列表里挑一個名字再brew install 包名。在 BrewUI 里搜索框直接集成了模糊匹配你輸入關(guān)鍵詞它會同時匹配 Formula 和 Cask并在結(jié)果里標(biāo)注出類型、版本、描述、所屬 tap 源。我實(shí)際用下來的體驗(yàn)是Cask 應(yīng)用的搜索提升最明顯。以前我想找個 GUI 應(yīng)用得先搞清楚它到底有沒有對應(yīng)的 cask名字是不是完全一致。在 BrewUI 里搜索結(jié)果直接展示應(yīng)用圖標(biāo)和官方描述基本不用猜。安裝流程在圖形界面里做成了兩段式先勾選要安裝的包系統(tǒng)會先做一次依賴解析把需要一起裝上的依賴包列出來讓你確認(rèn)然后再執(zhí)行安裝。這個設(shè)計其實(shí)很有用——命令行下brew install也會自動裝依賴但你往往意識不到裝了什么而圖形界面會強(qiáng)制你先看一眼避免不知不覺裝了一堆不相關(guān)的東西。4.2 一鍵查看可用更新有選擇地升級brew outdated這個命令我過去經(jīng)常敲但敲完往往只是看一眼不會立刻升級。不立刻升級的原因很簡單有些包升級后會連帶升級一堆依賴可能影響正在運(yùn)行的服務(wù)。BrewUI 的更新頁面把這個問題處理得比較舒服。它會把所有可更新包列成表格每行顯示當(dāng)前版本、最新版本、更新大小、這個包的依賴數(shù)量。你可以直接跳過某些不想更新的包只勾選想升級的然后點(diǎn)升級按鈕。升級過程中有實(shí)時的日志面板能清楚看到每一條輸出不用像終端里那樣干等著。批量升級的時候建議別把所有包一次性全勾上尤其是運(yùn)行中的服務(wù)依賴的運(yùn)行時版本比如python、node、mysql。我一般一次選 5 到 10 個相關(guān)度低的包跑完一批再選下一批這樣出問題容易定位。4.3 清理和診斷Homebrew 用久了/usr/local/Cellar里會積壓大量舊版本~/Library/Caches/Homebrew里會堆滿下載緩存。終端里清理需要brew cleanup或者手動指定包名在 BrewUI 里只需要進(jìn)清理頁面它會先算出可釋放的空間再讓你確認(rèn)一鍵清理。brew doctor的檢測結(jié)果也會在儀表盤上以警告卡片的形式呈現(xiàn)。哪里的軟鏈接失效了、哪個路徑混入了未知文件、哪個依賴版本沖突都會列成清單。每條警告后面通常還跟著一個修復(fù)按鈕點(diǎn)一下自動執(zhí)行對應(yīng)的修復(fù)命令。5. 換源、修權(quán)限、查依賴BrewUI處理進(jìn)階問題的三板斧5.1 鏡像源切換一次到位不用記命令Homebrew 默認(rèn)源都在 GitHub在國內(nèi)環(huán)境或者網(wǎng)絡(luò)不穩(wěn)定的情況下下載速度極慢。命令行換源需要依次修改 brew 本體、homebrew-core、homebrew-cask 三個倉庫的 remote 地址命令長、容易打錯而且換錯了會導(dǎo)致 update 直接報錯。BrewUI 的源管理頁面把這些操作封裝成了下拉選項(xiàng)。內(nèi)置了幾個常用鏡像源選中以后自動執(zhí)行倉庫地址替換并觸發(fā)一次brew update驗(yàn)證能否正常拉取。如果失敗再切回官方源或者另一個鏡像源來回切換的成本幾乎為零。我自己實(shí)測下來換了鏡像源以后brew update的速度從原來的幾十秒甚至卡死變成兩三秒內(nèi)完成。下載安裝包的速度也有明顯提升。5.2 目錄權(quán)限修復(fù)可視化定位權(quán)限問題權(quán)限類報錯在圖形界面里會以紅色卡片的形式出現(xiàn)在儀表盤上比如/usr/local/Caskroom is not writable.這個目視診斷在排查問題時比命令行高效——一眼就能看到具體是哪個目錄出了問題。BrewUI 里對這類問題有一個一鍵修復(fù)按鈕本質(zhì)是執(zhí)行sudo chown -R $(whoami) 對應(yīng)路徑。但注意一鍵修復(fù)需要你提前在配置里允許 BrewUI 執(zhí)行 sudo 命令否則它會提示你手動在終端執(zhí)行。個人建議如果你只有一臺個人機(jī)器環(huán)境相對干凈可以直接授權(quán)。如果機(jī)器上有多個開發(fā)項(xiàng)目共用還是手動執(zhí)行替換更穩(wěn)妥。5.3 依賴關(guān)系可視化清理多余的包不再只靠猜清理卸載的時候最怕的就是卸載了一個包結(jié)果連帶拆掉了另一個正在用的包依賴的底層庫。命令行里brew uses --installed 包名能查反向依賴但輸出格式比較簡陋。BrewUI 的依賴圖是我覺得最有記憶點(diǎn)的功能。它會把所有已安裝包畫成一張依賴關(guān)系圖你點(diǎn)某一個包能看到它依賴誰、誰依賴它。卸載前先在圖上確認(rèn)一下被卸載的包沒有被其他東西使用再下手。這個動作用命令行也能實(shí)現(xiàn)但圖的形式直觀太多。6. 徹底卸載Homebrew的清剿路線命令行和BrewUI配合有些情況下你還是得走卸載流程。比如 Intel Mac 上留著一套壞掉的 Homebrew 環(huán)境想推倒重來比如機(jī)器要交還給同事或轉(zhuǎn)賣需要清理個人工具鏈。這個環(huán)節(jié)最忌諱的就是直接rm -rf幾個目錄了事殘留的文件會在下次安裝時變著法子給你找麻煩。6.1 官方卸載腳本的正確用法Homebrew 官方提供了一鍵卸載腳本理論上執(zhí)行完可以清掉大部分文件/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)但這個腳本在網(wǎng)絡(luò)不穩(wěn)定的環(huán)境下也可能下載失敗。如果下載失敗就參考前面的方法通過鏡像站拉取 uninstall.sh 后本地執(zhí)行。腳本運(yùn)行過程中有幾個交互確認(rèn)包括用什么 shell 做模擬運(yùn)行直接回車確認(rèn)即可。有個細(xì)節(jié)值得注意官方 uninstall 腳本默認(rèn)只刪除 Homebrew 自身和它管理的 formula/cask 安裝目錄不會清理你放在~/Library/Application Support/Homebrew下的配置殘留也不會刪除它創(chuàng)建的部分緩存目錄。這幾處殘留恰恰是下次安裝出詭異問題的常見來源。6.2 手動清理的殘留路徑清單卸載腳本跑完之后建議再手動檢查一遍以下路徑。按 Intel Mac 的默認(rèn)布局來路徑內(nèi)容說明/usr/local/HomebrewHomebrew 本體倉庫腳本通常已處理確認(rèn)即可/usr/local/CellarFormula 安裝目錄腳本通常已處理/usr/local/CaskroomCask 應(yīng)用安裝目錄腳本通常已處理/usr/local/var/homebrew運(yùn)行數(shù)據(jù)、服務(wù)日志可能殘留/usr/local/etc下的 brew 相關(guān)配置各服務(wù)配置文件手動確認(rèn)刪除~/Library/Caches/Homebrew下載緩存經(jīng)常殘留~/Library/Logs/Homebrew操作日志經(jīng)常殘留~/Library/Application Support/Homebrew分析數(shù)據(jù)、權(quán)限數(shù)據(jù)庫經(jīng)常殘留/Library/Caches/Homebrew系統(tǒng)級緩存需要 sudo 刪除逐一檢查刪除的時候建議用rm -rf之前先du -sh看一眼大小確認(rèn)路徑?jīng)]有寫錯。多打一個斜杠的后果誰也說不清。6.3 用BrewUI輔助確認(rèn)清理結(jié)果如果你機(jī)器上還裝著另一套完整可用的 Homebrew比如從 Intel 遷移到 Apple Silicon 后兩套并存那么清剿殘留之后可以直接在 BrewUI 里交叉驗(yàn)證。具體做法是重新掃描一次安裝目錄確認(rèn)失效項(xiàng)為零。如果沒有另一套 BrewUI 環(huán)境也可以用一個最笨但很有效的方法驗(yàn)證打開終端執(zhí)行brew doctor看它還會不會報出和歷史相關(guān)的警告。如果報出/usr/local/Homebrew相關(guān)的內(nèi)容說明還有引用殘留需要繼續(xù)清理。提示卸載前最好先用 BrewUI 或者命令導(dǎo)出一份已安裝包清單brew bundle dump可以把所有 formula 和 cask 寫入一個Brewfile重裝后用brew bundle一鍵恢復(fù)。你在清理環(huán)境的時候往往意識不到這份清單的價值真到重裝完想找回那些包時才后悔莫及。7. 我從這臺老Intel Mac上得出的幾條經(jīng)驗(yàn)整套折騰下來我想寫幾條針對 Intel Mac 上 Homebrew 和 BrewUI 的體會它們不一定寫在官方文檔里但都是我實(shí)際踩過后總結(jié)出來的。第一Intel Mac 上的 Homebrew 問題一半是權(quán)限一半是殘留。如果你的安裝反復(fù)失敗先別急著重裝花幾分鐘確認(rèn)ls -la /usr/local的屬主情況再檢查~/Library/Caches/Homebrew是不是存在。這兩個點(diǎn)排查完大部分問題都能定位。第二換源要趁早不要等問題出現(xiàn)。我過去裝好 Homebrew 就懶得動源配置直到更新速度慢到影響工作了才換。實(shí)際上在安裝腳本階段就設(shè)置好HOMEBREW_BREW_GIT_REMOTE和HOMEBREW_CORE_GIT_REMOTE是最省事的方案后續(xù)所有操作都受益。第三圖形界面不是給菜鳥用的是給事情已經(jīng)夠多的人用的。就像 BrewUI它不會讓 Homebrew 變得更強(qiáng)但它能把頻繁操作從認(rèn)知負(fù)擔(dān)里剝離掉。每天下班前打開頁面看一眼有沒有重要更新點(diǎn)一下升級比打開終端敲命令然后盯著輸出感覺輕松不少。第四清理永遠(yuǎn)是最后的退出策略。如果你的環(huán)境已經(jīng)反復(fù)折騰到?jīng)]法收拾果斷卸載重裝反而比繼續(xù)修補(bǔ)省時。卸載時老老實(shí)實(shí)跑官方腳本再手動清理幾個緩存目錄十分鐘就能換來一個干凈的新環(huán)境。數(shù)據(jù)層面注意保留Brewfile和~/.zshrc里的環(huán)境變量配置這是你唯一需要備份的東西?；氐竭@臺老 Intel Mac 本身——Homebrew 修好之后我又把 BrewUI 裝起來給日常開發(fā)用。那臺機(jī)器配置早就不算新了但有了順手的環(huán)境管理工具繼續(xù)當(dāng)一臺安靜的折騰機(jī)器還是綽綽有余的。下次再聽到有人說Intel Mac 裝不了 Homebrew我心里大概就會冒出四個字哪跟哪兒啊。