先用一句話說(shuō)清楚 BrewUI 是什么它是 Homebrew 的圖形化管理界面把 brew 最常用的安裝、卸載、升級(jí)、服務(wù)管理、依賴查看這些操作從終端搬到了瀏覽器窗口里。很多人在 Mac 上裝 Homebrew 都交過(guò)學(xué)費(fèi)要么安裝腳本卡住半天沒(méi)反應(yīng)要么 Intel Mac 上死活裝不上好不容易裝完之后又不知道日常操作該怎么下手等想卸載的時(shí)候還發(fā)現(xiàn)系統(tǒng)里到處是殘留目錄。這篇文章不是我對(duì)著官方文檔念一遍而是我把 BrewUI 裝到兩臺(tái)機(jī)器之后的復(fù)盤(pán)一臺(tái)是 2017 年的 Intel iMac系統(tǒng)停在 macOS Monterey完整處理過(guò) Mac 安裝 Homebrew 報(bào)錯(cuò)的全過(guò)程另一臺(tái)是 Apple Silicon 的 MacBook Pro走的是全新環(huán)境。Intel Mac 安裝不了 Homebrew 的那部分我會(huì)把自己一步步試出來(lái)的排查順序?qū)懬宄ㄔ趺从苗R像源繞過(guò)網(wǎng)絡(luò)問(wèn)題、怎么處理殘留目錄、日?；静僮髟趺醋?、以及卸載 Homebrew 之后怎么清理干凈。無(wú)論你是剛接觸命令行的新手還是長(zhǎng)期用 macOS 的開(kāi)發(fā)者只要想把 brew 用得順手這篇都值得讀下去。1. 先別急著裝 BrewUI想清楚它到底解決什么問(wèn)題1.1 Homebrew 命令行本身很強(qiáng)但日常使用有“看不見(jiàn)”的痛點(diǎn)Homebrew 是 macOS 上最主流的包管理器這一點(diǎn)不用多解釋。它的價(jià)值在于把軟件安裝過(guò)程變成一條命令還幫你管理依賴、版本、卸載動(dòng)作理論上比手動(dòng)拖安裝包干凈得多。但真用起來(lái)命令行工具的毛病也很明顯它不會(huì)主動(dòng)告訴你哪些包可以升級(jí)了除非你定期想起來(lái)手動(dòng)敲brew outdated它也不會(huì)直觀展示這個(gè)軟件依賴了多少個(gè)子包、卸載之后會(huì)殘留什么brew services管理常駐服務(wù)時(shí)必須記參數(shù)brew cleanup、brew autoremove這類維護(hù)命令又很冷門很多人裝完軟件之后根本沒(méi)有意識(shí)去執(zhí)行。當(dāng)初我用命令行已經(jīng)比較熟練但面對(duì)一堆常年不更新的舊包還是經(jīng)?？克阉魅ゲ槊?。BrewUI 這類工具解決的就是這個(gè)問(wèn)題它把 brew 的狀態(tài)變成可視化的列表、按鈕和概況頁(yè)讓你不需要記住所有子命令也能把 Homebrew 管明白。1.2 BrewUI 的運(yùn)行原理它不是重新實(shí)現(xiàn) Homebrew只是給 brew 做個(gè)“遙控器”有一個(gè)特別重要的概念要先說(shuō)清楚BrewUI 本身不會(huì)去直接安裝軟件也不會(huì)繞過(guò)包管理器。它的后臺(tái)還是在調(diào)用 brew 的命令行接口只不過(guò)把 brew 輸出的文本和結(jié)構(gòu)化的 JSON 數(shù)據(jù)解析出來(lái)再渲染成網(wǎng)頁(yè)界面。你在界面上點(diǎn)了一個(gè)“升級(jí)按鈕”它執(zhí)行的本質(zhì)上還是brew upgrade你在界面里搜索一個(gè)軟件它背后跑的是brew search和brew info。這意味著如果 Homebrew 本身有問(wèn)題BrewUI 也會(huì)跟著出問(wèn)題。很多新手以為裝上圖形界面就萬(wàn)事大吉結(jié)果 UI 里紅字報(bào)錯(cuò)就以為是 BrewUI 壞了其實(shí)后臺(tái)是 brew 或系統(tǒng)沒(méi)配好。排查問(wèn)題的順序應(yīng)該是先驗(yàn)證brew --version和brew doctor是否正常再去看 BrewUI 報(bào)的錯(cuò)。理解這一點(diǎn)后面很多坑都能避開(kāi)。1.3 什么人不適合裝 BrewUI這部分我說(shuō)得直接一點(diǎn)BrewUI 不是給所有人準(zhǔn)備的。如果你是那種完全不碰命令行的人連“包管理”的概念都沒(méi)有我建議先掌握 brew 的十幾個(gè)核心命令再上 UI 工具否則出問(wèn)題你都描述不清楚。反過(guò)來(lái)如果你是重度開(kāi)發(fā)者所有操作都已經(jīng)條件反射也不一定需要常駐一個(gè) UI。我的建議是把 BrewUI 當(dāng)成“定期體檢入口”而不是“日常主界面”。每隔一兩周打開(kāi)看一眼全局狀態(tài)比每天在終端里反復(fù)敲命令要輕松很多。如果你只有一臺(tái) Mac又很在意工具鏈的簡(jiǎn)潔性可以先用命令行等感覺(jué)管理吃力了再把它加進(jìn)來(lái)。2. 安裝 BrewUI 前先做環(huán)境自查這幾步能省大量時(shí)間2.1 先分清芯片類型和 Homebrew 安裝路徑這是后面所有操作的地基Mac 從 Intel 遷移到 Apple Silicon 之后Homebrew 的默認(rèn)安裝路徑也變了。Intel Mac 上 Homebrew 安裝在/usr/local目錄Apple Silicon 上安裝在/opt/homebrew目錄。這個(gè)差異不只是“裝在哪兒”這么簡(jiǎn)單它直接影響 brew 命令能不能被找到、BrewUI 該配置哪個(gè)路徑。你可以用兩個(gè)命令確認(rèn)自己的芯片類型和當(dāng)前 brew 路徑uname -m which brew如果uname -m輸出x86_64是 Intel 芯片輸出arm64是 Apple Silicon。which brew可以返回 brew 可執(zhí)行文件的絕對(duì)路徑在 Intel 上通常會(huì)看到/usr/local/bin/brew在 Apple Silicon 上是/opt/homebrew/bin/brew。如果which brew沒(méi)有輸出說(shuō)明 Homebrew 還沒(méi)裝好或者 shell 的 PATH 變量有問(wèn)題需要先處理。2.2 Xcode Command Line Tools 沒(méi)裝好Homebrew 裝了也會(huì)反復(fù)報(bào)錯(cuò)很多人裝 Homebrew 報(bào)錯(cuò)源頭根本不在 Homebrew而在 Xcode Command Line Tools。這是一套命令行開(kāi)發(fā)工具Homebrew 編譯軟件、鏈接文件都得用到它。系統(tǒng)沒(méi)裝好時(shí)最常見(jiàn)的報(bào)錯(cuò)是xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun或者安裝腳本跑到一半提示找不到clang、make之類的編譯器。檢查命令很簡(jiǎn)單xcode-select -p如果正常會(huì)輸出類似/Library/Developer/CommandLineTools的路徑。如果提示找不到就執(zhí)行xcode-select --install安裝過(guò)程中會(huì)彈窗等它跑完即可。需要提醒的是有些人的 Command Line Tools 路徑存在但已經(jīng)損壞這時(shí)候可以先用sudo xcode-select --reset重置路徑再重新安裝。這個(gè)重置操作不會(huì)影響你已有的 Xcode 應(yīng)用。千萬(wàn)不要跳過(guò)這一步直接安裝 Homebrew否則后面每裝一個(gè)需要編譯的包都會(huì)撞墻。2.3 安裝前用三個(gè)命令做“體檢”版本、路徑和整體健康度確認(rèn)了芯片和命令行工具之后還要確認(rèn) Homebrew 本身是否可用。我會(huì)按順序跑三個(gè)命令brew --version which brew brew doctorbrew --version看版本是否正常which brew確認(rèn)當(dāng)前 shell 找到的是不是預(yù)期目錄里的 brewbrew doctor會(huì)輸出一堆警告和提示包括權(quán)限問(wèn)題、重復(fù)的工具鏈、不穩(wěn)定的 tap 源等。很多人看到brew doctor的輸出很長(zhǎng)就不看了這是錯(cuò)的。brew doctor的大部分提示可以忽略但有幾類必須處理提示某個(gè)目錄沒(méi)有寫(xiě)權(quán)限、提示重復(fù)安裝的軟件、提示 tap 源路徑錯(cuò)誤。這些問(wèn)題不解決BrewUI 之后的升級(jí)、卸載操作都可能失敗。如果brew doctor報(bào)告了很多條不要慌一條一條看。我自己的經(jīng)驗(yàn)是超過(guò) 80% 的警告只是提醒真正會(huì)讓工具不可用的只有權(quán)限和路徑問(wèn)題。3. 一步一步安裝 BrewUI順手把 Mac 安裝 Homebrew 報(bào)錯(cuò)解決掉3.1 官方安裝腳本本身就會(huì)遇到的報(bào)錯(cuò)先有個(gè)預(yù)期如果 Homebrew 還沒(méi)安裝標(biāo)準(zhǔn)的安裝命令是/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)這條命令會(huì)下載安裝腳本并執(zhí)行。但在實(shí)際網(wǎng)絡(luò)環(huán)境里這一步就足夠卡住很多人。字符串里的raw.githubusercontent.com在某些網(wǎng)絡(luò)環(huán)境下經(jīng)常超時(shí)報(bào)錯(cuò)通常是curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refused curl: (28) Operation timed out after 30000 milliseconds with 0 bytes received看到這種錯(cuò)誤不用懷疑操作不對(duì)就是網(wǎng)絡(luò)到 GitHub 的連接不穩(wěn)定。解決方法不是干等而是順手配置鏡像源。下面我會(huì)重點(diǎn)講 Intel Mac 上的場(chǎng)景。3.2 Intel Mac 安裝不了 Homebrew 的常見(jiàn)原因和鏡像源處理先說(shuō)結(jié)論Intel Mac 安裝不上 Homebrew大部分不是機(jī)器老了而是網(wǎng)絡(luò)和安裝殘留的組合問(wèn)題。我自己在 2017 年的 iMac 上就遇到過(guò)三種典型現(xiàn)場(chǎng)。第一種是安裝腳本下載階段超時(shí)。這很容易判斷報(bào)錯(cuò)里會(huì)出現(xiàn)curl和超時(shí)時(shí)間。解決辦法是配置 Git 倉(cāng)庫(kù)鏡像源把 brew 官方源替換成可用的開(kāi)源鏡像源。環(huán)境變量可以這樣設(shè)置export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.example.com/git/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.example.com/git/homebrew/homebrew-core.git export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.example.com/homebrew-bottles export HOMEBREW_NO_AUTO_UPDATE1其中HOMEBREW_BREW_GIT_REMOTE是 brew 主倉(cāng)庫(kù)源HOMEBREW_CORE_GIT_REMOTE是軟件包倉(cāng)庫(kù)源HOMEBREW_BOTTLE_DOMAIN是預(yù)編譯包的下載源。替換成可用的鏡像源后整個(gè)安裝過(guò)程會(huì)順暢很多。注意不同鏡像站的路徑結(jié)構(gòu)不一樣以你選的鏡像站幫助文檔為準(zhǔn)。第二種原因是之前安裝失敗留下的殘留目錄。比如提示Error: /usr/local/Homebrew is not a directory.這說(shuō)明舊版本安裝沒(méi)卸載干凈。處理方法是先手動(dòng)刪除殘留再重新運(yùn)行安裝腳本sudo rm -rf /usr/local/Homebrew sudo rm -rf /usr/local/Caskroom sudo rm -rf /usr/local/Cellar刪除目錄是很重的操作請(qǐng)先確認(rèn)里面沒(méi)有你沒(méi)備份的東西。如果只是/usr/local/Homebrew這一個(gè)目錄殘留優(yōu)先只刪它不要一上來(lái)就清空整個(gè)/usr/local。第三種原因是系統(tǒng)版本太舊或 Command Line Tools 損壞。舊版 macOS 上安裝新版本 Homebrew腳本會(huì)檢查系統(tǒng)版本不滿足時(shí)直接退出。這種時(shí)候我不會(huì)建議繼續(xù)折騰能升級(jí)系統(tǒng)就升級(jí)不能升級(jí)就考慮用對(duì)應(yīng)舊版本的公式倉(cāng)庫(kù)但這對(duì)普通用戶來(lái)說(shuō)維護(hù)成本很高性價(jià)比很低。先修 Command Line Tools 再重試往往比換分支靠譜。3.3 安裝 BrewUI 的通用步驟下載、解壓、運(yùn)行當(dāng) Homebrew 本身能正常工作時(shí)安裝 BrewUI 就相對(duì)簡(jiǎn)單。我用的版本是以 Web 界面方式運(yùn)行的獨(dú)立程序安裝邏輯如下。可以從 BrewUI 項(xiàng)目的 GitHub Releases 頁(yè)面下載對(duì)應(yīng) macOS 的壓縮包選擇時(shí)注意芯片類型Intel 下載amd64版本Apple Silicon 下載arm64版本。下載后解壓到一個(gè)固定目錄我習(xí)慣放在~/Applications/BrewUI下mkdir -p ~/Applications/BrewUI tar -zxf brewui_darwin_amd64.tar.gz -C ~/Applications/BrewUI cd ~/Applications/BrewUI具體文件名以你下載到的版本為準(zhǔn)不同時(shí)期的打包方式可能不同。解壓后一般會(huì)得到一個(gè)可執(zhí)行文件或一個(gè)啟動(dòng)腳本用./直接運(yùn)行即可啟動(dòng)服務(wù)。我通常用這樣的命令./brewui serve --port 8787 --brew-path $(which brew) ~/.brewui.log 21 啟動(dòng)后打開(kāi)瀏覽器訪問(wèn)http://127.0.0.1:8787就能看到界面了。這個(gè)--brew-path參數(shù)非常重要它讓 UI 明確知道自己該調(diào)用哪個(gè) brew。如果本機(jī)同時(shí)存在多個(gè) Homebrew 環(huán)境不指定路徑很容易調(diào)到錯(cuò)誤版本。如果你更喜歡讓它以后臺(tái)服務(wù)方式運(yùn)行可以用brew services start brewui但前提是 BrewUI 本身已經(jīng)被打包成可用的 formula 或 cask。這個(gè)以項(xiàng)目文檔為準(zhǔn)不同發(fā)行版差別很大。手動(dòng)用nohup方式啟動(dòng)雖然簡(jiǎn)陋但也不容易出問(wèn)題。3.4 首次打開(kāi)界面先做這三項(xiàng)配置BrewUI 首次打開(kāi)后不要急著點(diǎn)升級(jí)先把三個(gè)配置確認(rèn)好。第一確認(rèn) brew 可執(zhí)行文件路徑。界面里一般會(huì)有一個(gè)設(shè)置頁(yè)或環(huán)境檢測(cè)頁(yè)顯示檢測(cè)到的 brew 版本。如果顯示為空手動(dòng)填入which brew的輸出路徑。第二確認(rèn) shell 環(huán)境。BrewUI 在后臺(tái)調(diào)用 brew 時(shí)需要繼承一個(gè)完整的用戶環(huán)境否則 PATH 不對(duì)就找不到命令。很多 Web 管理工具都會(huì)提供“是否使用 login shell”的選項(xiàng)建議打開(kāi)。第三注意權(quán)限邊界。我不建議在 UI 界面里保存密碼、也不建議讓后臺(tái)自動(dòng)以 sudo 方式執(zhí)行安裝命令。brew 本身只在少數(shù)場(chǎng)景需要 sudo日常安裝卸載都不需要。如果 UI 提示某個(gè)操作需要管理員權(quán)限你要先看命令內(nèi)容而不是直接授權(quán)。這是我給大家的硬性建議任何包管理器前端工具都不要做成“自動(dòng)提權(quán)模式”否則一旦 UI 被攻擊機(jī)器就等于裸奔。4. BrewUI 的基本操作日常裝包、更新和清理都用得上4.1 過(guò)一段時(shí)間就看看 outdated別等軟件全亂才處理Homebrew 的基本操作里大家最常用但最容易忘的就是“檢查更新”。在終端里對(duì)應(yīng)的命令是brew update brew outdatedbrew update同步遠(yuǎn)程倉(cāng)庫(kù)brew outdated列出所有本地已安裝、但遠(yuǎn)端有新版可用的包。在 BrewUI 里這兩個(gè)操作通常被合并成一個(gè)“檢查更新”按鈕點(diǎn)一下就能看到 out of date 列表?？吹搅斜碇蟛灰]眼點(diǎn)“全選升級(jí)”。我踩過(guò)坑一次把所有軟件全部升級(jí)結(jié)果某個(gè)命令行工具的新版本不兼容項(xiàng)目腳本折騰了一個(gè)下午才回滾?，F(xiàn)在我的習(xí)慣是分兩批處理先升級(jí)日常開(kāi)發(fā)工具再升級(jí)語(yǔ)言運(yùn)行時(shí)和系統(tǒng)級(jí)工具。如果界面支持按 tag 過(guò)濾就把編譯器和運(yùn)行時(shí)單獨(dú)篩選出來(lái)升級(jí)前用下面的命令記錄當(dāng)前版本brew list --versions ~/Desktop/brew_versions_backup.txt這個(gè)命令會(huì)把當(dāng)前所有包和版本號(hào)導(dǎo)出萬(wàn)一升級(jí)后崩了至少能知道應(yīng)該回滾到哪個(gè)版本。4.2 安裝和卸載軟件時(shí)UI 里親眼能看到依賴關(guān)系在終端安裝軟件是brew install 包名卸載是brew uninstall 包名看起來(lái)很簡(jiǎn)單但復(fù)雜的是依賴關(guān)系。有的包裝完之后會(huì)帶回十幾個(gè)依賴庫(kù)卸載主包時(shí)這些依賴并不會(huì)自動(dòng)消失需要手動(dòng)執(zhí)行brew autoremoveBrewUI 的價(jià)值在這里體現(xiàn)得很明顯。它會(huì)把依賴樹(shù)畫(huà)出來(lái)安裝前你能看到“這個(gè)包會(huì)給系統(tǒng)多帶多少東西”卸載前也能看到“哪些依賴會(huì)被孤立出來(lái)”。我的建議是卸載一個(gè)軟件之后順手點(diǎn)一下“清理孤立依賴”長(zhǎng)期積累下來(lái)能給磁盤(pán)省下幾個(gè) GB。具體操作對(duì)應(yīng)命令就是上面的brew autoremove。還有一個(gè)細(xì)節(jié)如果你想安裝指定版本終端命令是brew install 包名版本號(hào)比如brew install python3.10。UI 里通常也支持在搜索框里輸入帶版本號(hào)的名稱或者在已安裝列表里切換版本。搞清楚這個(gè)你就知道“在 UI 里裝舊版本”不是圖形界面單獨(dú)實(shí)現(xiàn)的功能而是 brew 本身支持多版本并存。4.3 管理后臺(tái)常駐服務(wù)brew services 的可視化很多 macOS 開(kāi)發(fā)者都用 brew 安裝過(guò) MySQL、Redis、Nginx 這類常駐服務(wù)。終端命令是brew services list brew services start mysql brew services stop mysql brew services restart redis這個(gè)命令鏈很容易記混尤其服務(wù)一多狀態(tài)是started、stopped還是error直接掃列表很累人。BrewUI 里一般會(huì)有一個(gè) Services 頁(yè)簽把所有用 brew 安裝的服務(wù)列成一張表狀態(tài)一列是綠點(diǎn)或紅點(diǎn)旁邊就是啟動(dòng)、停止、重啟按鈕還經(jīng)常能看到配置文件路徑和日志路徑。需要注意一個(gè)邊界brew services啟動(dòng)的服務(wù)是用戶級(jí)服務(wù)不是系統(tǒng)級(jí) daemon它的生命周期和當(dāng)前用戶登錄狀態(tài)有關(guān)。雖然開(kāi)機(jī)也會(huì)自動(dòng)拉起但它是普通用戶進(jìn)程不要指望它能提供跟系統(tǒng) daemon 一樣的權(quán)限和隔離。用 UI 管理這類服務(wù)很方便但你要清楚自己在管的是哪一層的東西。4.4 清理緩存和舊版本界面里的“清理”不要亂點(diǎn)brew cleanup是另一個(gè)很多人聽(tīng)過(guò)卻不怎么用的命令它負(fù)責(zé)清理舊版本的軟件包和下載緩存。終端里先用下面的命令預(yù)覽brew cleanup -n-n是 dry-run只顯示會(huì)刪除什么不真正刪除。確認(rèn)沒(méi)問(wèn)題再去掉-n執(zhí)行。BrewUI 一般會(huì)把清理動(dòng)作做成一個(gè)按鈕點(diǎn)擊前建議先看一眼預(yù)覽結(jié)果。另外brew cleanup并不會(huì)卸載那些“不再被依賴的包”它只清理版本殘留。要把無(wú)用依賴也刪掉還是需要brew autoremove配合。我的習(xí)慣是先把清理預(yù)覽看一遍再執(zhí)行 autoremove最后再看一眼磁盤(pán)占用du -sh $(brew --cache)這個(gè)命令顯示 brew 緩存目錄占了多少空間。如果長(zhǎng)期沒(méi)清理幾十 GB 也是有可能的。5. Intel Mac 和舊系統(tǒng)重災(zāi)區(qū)那些安裝失敗的真實(shí)現(xiàn)場(chǎng)5.1 Intel 老機(jī)器上的三個(gè)安裝現(xiàn)場(chǎng)分別是怎么排查的我在 Intel iMac 上遇到的第一個(gè)現(xiàn)場(chǎng)安裝腳本下載階段直接報(bào)curl: (7) Connection refused。這種問(wèn)題其實(shí)和 Intel 不 Intel 沒(méi)關(guān)系就是網(wǎng)絡(luò)連不上 GitHub。處理方法就是前面說(shuō)的先設(shè)置鏡像源環(huán)境變量再跑安裝腳本。我沒(méi)有選擇無(wú)限重試因?yàn)橹卦嚾我陨匣究梢源_認(rèn)網(wǎng)絡(luò)路徑有問(wèn)題。第二個(gè)現(xiàn)場(chǎng)xcrun: error: invalid active developer path。這臺(tái) iMac 之前可能被調(diào)整過(guò) Command Line Tools路徑指向了一個(gè)不存在的目錄。我先執(zhí)行xcode-select --reset再執(zhí)行xcode-select --install重新安裝后問(wèn)題消失。這是很多“Intel Mac 安裝不了 Homebrew”的隱藏原因因?yàn)闄C(jī)器年份老容易有歷史遺留的路徑調(diào)整。第三個(gè)現(xiàn)場(chǎng)安裝腳本執(zhí)行到一半提示某個(gè)目錄權(quán)限不足。這類報(bào)錯(cuò)在/usr/local下很常見(jiàn)因?yàn)?usr/local的屬主不是當(dāng)前用戶。處理方法是sudo chown -R $(whoami) /usr/local這句話的意思是把/usr/local目錄歸屬權(quán)還給自己。但我要提醒如果系統(tǒng)對(duì)/usr/local做了額外的安全策略這個(gè)命令可能不生效需要去系統(tǒng)設(shè)置里檢查目錄權(quán)限。別小看這一步它直接決定后續(xù)brew install能不能寫(xiě)入目錄。5.2 網(wǎng)絡(luò)超時(shí)不只能傻等幾個(gè)環(huán)境變量能減少大量失敗網(wǎng)絡(luò)問(wèn)題可以說(shuō)是 Mac 安裝 Homebrew 報(bào)錯(cuò)里最高頻的類型。除了依賴鏡像源另外一個(gè)很容易被忽略的變量是HOMEBREW_NO_AUTO_UPDATE。安裝或升級(jí)軟件時(shí)Homebrew 默認(rèn)會(huì)先拉取更新這會(huì)導(dǎo)致安裝動(dòng)作被拖慢很多。如果你構(gòu)建的是一個(gè)穩(wěn)定的開(kāi)發(fā)環(huán)境不追求每次安裝都拿到最新公式可以設(shè)置export HOMEBREW_NO_AUTO_UPDATE1這個(gè)變量會(huì)讓 Homebrew 跳過(guò)自動(dòng)更新直接執(zhí)行安裝。缺點(diǎn)是你可能安裝到相對(duì)舊一點(diǎn)的版本定義文件但至少能安裝成功。長(zhǎng)期一直開(kāi)著也不好我通常只在網(wǎng)絡(luò)差或者臨時(shí)裝包時(shí)顯式加上這個(gè)環(huán)境變量等網(wǎng)絡(luò)穩(wěn)定后再正常跑一次brew update。還有兩個(gè)環(huán)境變量也可能用到一個(gè)是HOMEBREW_NO_ANALYTICS1關(guān)閉匿名統(tǒng)計(jì)上報(bào)另一個(gè)是HOMEBREW_VERBOSE1打印詳細(xì)日志。排查網(wǎng)絡(luò)相關(guān)的安裝失敗時(shí)打開(kāi)HOMEBREW_VERBOSE能看到每一行請(qǐng)求和重試時(shí)間定位慢在哪一步非常有用。5.3 從 Intel 切到 Apple Siliconbrew 路徑打架怎么處理現(xiàn)在還有一種常見(jiàn)情況遷移助手把 Intel 時(shí)代的數(shù)據(jù)搬到了 Apple Silicon 新機(jī)器上結(jié)果新機(jī)器/opt/homebrew和遷過(guò)來(lái)的/usr/local里都有 Homebrew。兩個(gè)目錄共存時(shí)which brew指向哪個(gè)BrewUI 就會(huì)去調(diào)動(dòng)哪個(gè)非常容易造成混亂。解決思路是只保留一個(gè) Homebrew。如果你當(dāng)前機(jī)器是 Apple Silicon通常應(yīng)該優(yōu)先用/opt/homebrew/bin/brew把/usr/local里舊的 brew 相關(guān)目錄清理掉。但清理前要注意舊 brew 安裝的軟件可能還在運(yùn)行。我建議先停掉舊 brew services再卸載舊包最后刪目錄。如果因?yàn)槟承┰虮仨毐Ａ?Intel 版軟件環(huán)境可以用arch命令顯式指定執(zhí)行環(huán)境。比如在 Apple Silicon 上調(diào)用 Intel 版arch -x86_64 /usr/local/bin/brew list這些場(chǎng)景網(wǎng)上討論很多但核心原則就一條BrewUI 也好終端也好都要保證你調(diào)用的是同一個(gè) Homebrew不能讓 PATH 變量在不同 shell 里指向不同位置。6. 卸載 BrewUI 與 Homebrew 殘留清理別把系統(tǒng)越搞越臟6.1 卸載 BrewUI 別漏掉進(jìn)程、配置和緩存卸載 BrewUI 聽(tīng)起來(lái)很簡(jiǎn)單把應(yīng)用目錄刪除就好。但實(shí)際要處理四樣?xùn)|西。第一停止正在運(yùn)行的進(jìn)程。如果之前是用nohup方式啟動(dòng)先找到對(duì)應(yīng)進(jìn)程并殺掉pkill -f brewui如果之前注冊(cè)成了 brew services 或 launchd 服務(wù)先停止服務(wù)包括brew services stop brewui第二刪除解壓出來(lái)的程序目錄通常是我之前創(chuàng)建的~/Applications/BrewUI。第三刪除配置文件和數(shù)據(jù)目錄。這類 Web 工具一般會(huì)把配置放在~/.config/BrewUI或~/Library/Application Support/BrewUI還有一個(gè)可能的位置是~/.brewui.yaml。刪除前先打開(kāi)配置文件看一眼別誤刪了其他工具。第四清理日志和緩存比如~/.brewui.log、~/Library/Caches下與 BrewUI 相關(guān)的緩存。如果你是通過(guò)brew install --cask安裝的 BrewUI正常的卸載方式是brew uninstall --cask brewui它會(huì)處理應(yīng)用文件和部分緩存但未裝入 Applications 的用戶配置文件不一定自動(dòng)刪除還是需要手動(dòng)檢查。6.2 Homebrew 卸載殘留一般藏在哪幾個(gè)目錄關(guān)于“homebrew 卸載殘留”一定要有目錄概念否則會(huì)覺(jué)得系統(tǒng)里到處都是不知道從哪下手。主要?dú)埩粑恢萌缦?opt/homebrew或/usr/local/HomebrewHomebrew 的主目錄卸載不干凈時(shí)這里是最大的一塊。/usr/local/Caskroom、/usr/local/Cellar軟件包和 cask 安裝目錄很多用戶忘記刪。~/Library/Caches/Homebrew下載緩存空間浪費(fèi)大戶。~/Library/Logs/Homebrew日志目錄。~/Library/Preferences下與 Homebrew 相關(guān)的 plist 文件。環(huán)境變量文件里的配置~/.zshrc或~/.bash_profile中可能寫(xiě)了eval $(/opt/homebrew/bin/brew shellenv)卸載之后也要?jiǎng)h掉否則 shell 每次啟動(dòng)都要報(bào)一次路徑不存在。我在清理老機(jī)器時(shí)先執(zhí)行了這樣一條命令看總占用du -sh /usr/local/Homebrew ~/Library/Caches/Homebrew真的把哪些平時(shí)看不到的目錄統(tǒng)計(jì)出來(lái)你才會(huì)對(duì)“殘留”有直觀感知。6.3 我的清理順序先卸載軟件再跑官方腳本最后手動(dòng)掃我清理 Homebrew 的順序是固定的不建議反過(guò)來(lái)。第一步先卸載所有通過(guò) brew 安裝的 formula 和 cask。你可以在終端先列出全部brew list --formula brew list --cask然后逐個(gè)brew uninstall 包名或者用上面導(dǎo)出版本列表的方式一條條處理。之所以要先卸載軟件是因?yàn)橹苯觿h目錄會(huì)導(dǎo)致動(dòng)態(tài)庫(kù)、配置文件、服務(wù)文件散落在系統(tǒng)里之后想清都不知道從哪清。第二步停掉所有 brew services避免卸載過(guò)程中服務(wù)自動(dòng)重啟。第三步運(yùn)行官方卸載腳本/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)腳本會(huì)列出將要?jiǎng)h除的目錄然后問(wèn)你是否繼續(xù)。注意它不會(huì)自動(dòng)清空用戶配置文件所以還有最后一步。第四步手動(dòng)檢查殘留。重點(diǎn)看~/Library/Caches/Homebrew、~/Library/Logs/Homebrew、/usr/local/Homebrew這些目錄還在不在順便檢查你的 zsh 或 bash 配置文件里還有沒(méi)有 brew 的初始化代碼。沒(méi)有把握的目錄不要硬刪尤其是/usr/local整個(gè)目錄里面可能還有 Python、Node 以及其他工具寫(xiě)在里面。整個(gè)卸載過(guò)程沒(méi)有特別高的技術(shù)難度但很考驗(yàn)?zāi)托浴Ｎ疫@臺(tái) iMac 清理之后系統(tǒng)盤(pán)釋放了接近十幾 GB比換新機(jī)的體感還明顯。最后分享一個(gè)我自己的使用習(xí)慣我現(xiàn)在不會(huì)天天打開(kāi) BrewUI但每隔一兩周會(huì)打開(kāi)它看一次 outdated 和全局狀態(tài)。做批量升級(jí)前我一定會(huì)記錄當(dāng)前版本列表再用 UI 分批處理。遇到 UI 報(bào)錯(cuò)時(shí)我不會(huì)急著提 bug而是先切到終端跑一遍brew doctor和對(duì)應(yīng)命令確認(rèn)是 brew 環(huán)境問(wèn)題還是 UI 工具問(wèn)題。BrewUI 這類工具的意義不是替代 Homebrew而是讓那些不常用的管理功能在你需要的時(shí)候能馬上找到、能用得起來(lái)。希望這份記錄能幫你少踩一些坑。