Disinstallare Homebrew con lo script ufficiale

Homebrew fornisce un disinstallatore ufficiale, e fa quello che dice. La sorpresa è la portata: rimuove Homebrew e rimuove ciò che Homebrew ha installato. Il peso di questi due fatti dipende dal motivo per cui sei qui.

Se ti serve solo spazio su disco, controlla quanto usa Homebrew prima di toglierlo. Se una sola formula dà problemi, disinstallare l'intero ambiente è inutile.

Prima di andare avanti, annota brew leaves e l'elenco dei cask. Poi esegui il disinstallatore ufficiale con --dry-run e leggi la portata come se fosse un piano di cancellazione. Se il problema è un solo pacchetto, fermati qui e usa brew uninstall, oppure segui il percorso più sicuro di pulizia di Homebrew.

Quando non dovresti disinstallare Homebrew

Salta l'opzione nucleare se vale uno di questi casi:

• Una formula o un cask è rotto: usa brew uninstall <name>, poi brew autoremove se le dipendenze restano orfane.
• Ti serve solo spazio: brew cleanup -s cancella vecchie versioni e download senza eliminare il prefisso.
• Ti servono ancora git, node, python, server di database o strumenti CLI arrivati da Homebrew. Il disinstallatore porta via Cellar e Caskroom.
• Prevedi di reinstallare lo stesso stack domani sullo stesso Mac. Esporta gli elenchi sotto, pulisci con brew cleanup e tieni l'installazione.

Disinstalla quando lasci Homebrew per sempre, migri a un prefisso pulito dopo un'installazione rotta, o svuoti una macchina dove non vuoi più nessuno di quei pacchetti.

Conosci il tuo prefisso: Intel, Apple Silicon e residui Rosetta

Il prefisso predefinito di Homebrew dipende dal chip:

Conferma cosa hai davvero prima di cancellare qualsiasi cosa:

uname -m
brew --prefix
which brew

arm64 è Apple Silicon. x86_64 è Intel (o un terminale Rosetta). Su un Mac Apple Silicon migrato, un vecchio Homebrew Intel sotto /usr/local può ancora esistere accanto a /opt/homebrew. Lo script ufficiale di disinstallazione cerca il predefinito della macchina e, su arm64, considera anche /usr/local così un prefisso Intel residuo non viene perso. Se tieni due prefissi di proposito, passa --path per rimuovere quello che intendi.

Non cancellare a mano tutto /usr/local su Intel. Quella directory è condivisa con altro software. Usa lo script ufficiale, che punta agli alberi propri di Homebrew.

Il disinstallatore ufficiale

La FAQ di Homebrew punta allo script di disinstallazione nel repository Homebrew/install. Preferisci copiare il comando da quella pagina se Homebrew lo cambia. L'one-liner attuale è:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

Se vuoi leggere lo script prima che venga eseguito, scaricalo prima:

curl -O https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh
less uninstall.sh
/bin/bash uninstall.sh --help

Flag utili:

• --dry-run (anche -n): stampa cosa verrebbe rimosso e non cambia nulla. Inizia da qui su una macchina a cui tieni.
• --path=PATH: disinstallare un prefisso specifico (per esempio /usr/local su Apple Silicon dopo un'installazione dell'era Rosetta).
• --force: salta la conferma (implicito anche quando è impostato NONINTERACTIVE).
• --skip-cache-and-logs: lascia stare le directory di cache e log.

Ignora il vecchio gist mxcl e qualsiasi guida che dica ancora di fare cd $(brew --prefix) e cancellare con git ls-files. Quel flusso mirava al layout iniziale di /usr/local ed è pericoloso sulle installazioni moderne.

Cosa cancella davvero lo script

Il disinstallatore rimuove il prefisso Homebrew e le directory sotto di esso: bin, etc, include, lib, opt, sbin, share, var, Frameworks, e sia Cellar sia Caskroom.

Queste ultime due sono il punto. Cellar è dove vivono i file di ogni formula, Caskroom dove vivono i metadati dei cask. Rimuovere Homebrew li rimuove, quindi ogni strumento a riga di comando installato tramite di esso sparisce insieme.

Pulisce anche ~/Library/Caches/Homebrew e ~/Library/Logs/Homebrew, la cache Homebrew a livello di sistema, /etc/paths.d/homebrew, e le app gestite da Homebrew in /Applications e ~/Applications.

Annota cosa hai prima di rimuoverlo

Esporta l'inventario prima della disinstallazione con questi due comandi:

brew leaves > ~/Desktop/brew-formulae.txt
brew list --cask > ~/Desktop/brew-casks.txt

brew leaves elenca le formula da cui non dipende nessun'altra formula o cask installato. È un punto di partenza utile, non un registro completo di tutto ciò che hai installato in modo esplicito. Rileggi questi due file prima di usarli per ricostruire l'ambiente.

Controlla i dati dei pacchetti separatamente dai file dei pacchetti. La configurazione nella home può restare, ma un database Postgres sotto /opt/homebrew/var o /usr/local/var è ancora dentro il prefisso Homebrew. Il disinstallatore rimuove var, quindi i dati lì possono andarsene con esso. Fai un backup fuori dal prefisso di ciò che ti serve prima di disinstallare. Ferma prima i servizi se li usi:

brew services list
brew services stop --all

Opzionale: rimuovere prima formula e cask

Se vuoi uno smontaggio a tappe invece di un passaggio nucleare, disinstalla i pacchetti mentre brew funziona ancora:

brew list --formula
brew uninstall --force $(brew list --formula)
brew list --cask
brew uninstall --cask --force $(brew list --cask)
brew autoremove
brew cleanup -s

Questo svuota Cellar e Caskroom ma lascia l'installazione di Homebrew. Usalo quando non sei sicuro dei dati sotto var, o quando vuoi liberare spazio dei pacchetti e tenere brew per un set di strumenti più piccolo più avanti. Quando hai finito con Homebrew stesso, esegui comunque il disinstallatore ufficiale così prefisso, tap e cache spariscono in modo pulito.

Eseguire la disinstallazione

1. Esegui con --dry-run e leggi ogni percorso.
2. Esegui senza --dry-run, digita y quando richiesto e inserisci la password di macOS se serve sudo per directory protette.
3. Copia qualsiasi elenco «possible Homebrew files were not deleted» dal terminale prima di chiudere la finestra.

Esempio di dry-run dopo aver scaricato lo script:

/bin/bash uninstall.sh --dry-run

Oppure con l'one-liner remoto: scarica prima per poter passare i flag senza annidare virgolette in modo goffo, poi esegui /bin/bash uninstall.sh.

Checklist dei file residui

Quando lo script finisce può segnalare che alcuni possibili file di Homebrew non sono stati cancellati e che potresti volerli rimuovere tu, seguito dall'elenco.

È l'unico posto in cui quei percorsi vengono mai nominati. Di solito dipende da permessi su directory che Homebrew non ha creato, e l'elenco è breve. Copialo prima di chiudere il terminale, perché rieseguire il disinstallatore su un'installazione già rimossa non lo riprodurrà.

I residui tipici stanno sotto il prefisso che hai appena rimosso:

• Apple Silicon: /opt/homebrew/etc, share, var, Frameworks e directory vuote o con proprietà parziale simili
• Intel: gli stessi nomi sotto /usr/local, ma non cancellare mai alberi non correlati di /usr/local a occhio

Se lo script ha nominato un percorso e hai confermato che è solo di Homebrew, rimuovilo in modo esplicito (spazio dopo -rf):

sudo rm -rf /opt/homebrew/share

Poi verifica:

ls /opt/homebrew
ls /usr/local/Homebrew
ls ~/Library/Caches/Homebrew
ls ~/Library/Logs/Homebrew

Aspettati «No such file or directory» una volta che quelle posizioni sono sparite. Se /opt/homebrew o un albero solo Homebrew esiste ancora e lo script ha già finito, sudo rm -rf su quel percorso è la pulizia usuale. Ricontrolla il percorso prima di premere Return.

La configurazione dei pacchetti fuori dal prefisso spesso resta di proposito: ~/.gitconfig, gestori di versioni dei linguaggi, cartelle di supporto app sotto ~/Library e database che hai spostato fuori da var. Quello non è il prefisso di Homebrew. Rimuovili solo quando sai a cosa appartengono.

Il profilo shell lo menziona ancora

Il disinstallatore non modifica .zprofile, .zshrc, .zshenv, .zlogin né .bash_profile. La riga che l'installer di Homebrew aggiunge di solito è così:

eval "$(/opt/homebrew/bin/brew shellenv)"

Sui Mac Intel il PATH predefinito include già /usr/local/bin, quindi molte installazioni non hanno mai avuto bisogno di quella riga. Su Apple Silicon è necessaria per trovare brew, e dopo la disinstallazione ogni nuovo shell prova a eseguire un binario che non esiste più.

Cerca e rimuovi brew shellenv (e qualsiasi export PATH a /opt/homebrew/bin o /usr/local/bin aggiunto a mano di cui non hai più bisogno):

grep -n "brew shellenv\|/opt/homebrew\|/usr/local/bin" ~/.zprofile ~/.zshrc ~/.zshenv ~/.zlogin ~/.bash_profile ~/.bashrc 2>/dev/null

Apri poi una nuova scheda del terminale. Se l'avviso è sparito e which brew non stampa nulla, la pulizia del PATH è fatta. Lascia la riga solo se prevedi di reinstallare subito.

Modalità di errore comuni

Permission denied sui residui. Lo script ha elencato i percorsi ma non è riuscito a cancellarli. Usa sudo rm -rf su ogni percorso nominato, con uno spazio tra -rf e il percorso. rm -rf/opt/... fallisce con illegal option perché il percorso è stato letto come flag.

Disinstallazione parziale / «Homebrew is already installed». Un tentativo precedente ha lasciato .git, Cellar o bin/brew. Riesegui lo script ufficiale con il --path corretto, oppure rimuovi il prefisso residuo segnalato dallo script, poi reinstalla dalla documentazione di installazione di Homebrew se ti serve ancora.

brew: command not found dopo una pulizia a metà. O la disinstallazione è finita e il PATH punta ancora al vecchio prefisso (sistema la riga dello shell), oppure brew è sparito mentre i pacchetti restano. Non inseguire il gist classico. Usa lo script ufficiale con --path se esiste ancora una directory di prefisso.

Prefisso sbagliato su Apple Silicon. Hai rimosso /opt/homebrew ma gli strumenti dell'era Rosetta vivono ancora sotto /usr/local. Esegui lo script con --path=/usr/local dopo aver confermato che quell'albero è di Homebrew, non un mix di software non correlato.

Servizi e elementi di login continuano a chiamare binari mancanti. Ferma brew services prima della disinstallazione quando puoi. Poi controlla gli elementi di login e qualsiasi LaunchAgent che riferisca ancora /opt/homebrew o /usr/local/Cellar.

Vecchi post di blog e il gist del 2011. Le guide che cancellano con git ls-files e pbcopy appartengono a un layout precedente di Homebrew. Preferisci solo https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh.

Valuta se basta l'operazione più piccola

Per una pulizia più piccola, brew cleanup rimuove vecchie versioni e download in cache, brew uninstall <formula> rimuove un pacchetto e brew autoremove rimuove dipendenze inutilizzate. Nella vista Analyze di Mole, scansiona la cartella Homebrew prima della pulizia e di nuovo dopo per confrontarne la dimensione. Mole non tiene traccia automaticamente delle modifiche fatte da questi comandi.

Ricostruire dall'elenco esportato

Una volta installato Homebrew sulla nuova macchina, due comandi ripristinano ciò che avevi:

xargs brew install < brew-formulae.txt
xargs brew install --cask < brew-casks.txt

Restano separati perché i cask richiedono --cask, e un elenco misto fallisce su metà delle voci.

brew list include le dipendenze, quindi riprodurre l'elenco intero segna quei pacchetti come richiesti in modo esplicito e cambia ciò che brew autoremove potrà rimuovere in seguito. brew leaves evita gran parte di questo, ma non è la stessa cosa della cronologia dei pacchetti richiesti: un pacchetto che hai scelto può anche essere richiesto da un altro. Rileggi l'elenco e aggiungi gli strumenti di cui hai ancora bisogno prima di reinstallare.

Domande frequenti

Disinstallare Homebrew rimuove tutti i pacchetti che ha installato?

Sì per tutto ciò che è ancora dentro Cellar e Caskroom. Lo script ufficiale rimuove il prefisso, quindi formula e metadati dei cask vanno via con esso. Configurazione e dati fuori dal prefisso possono restare.

Qual è la differenza tra /opt/homebrew e /usr/local?

/opt/homebrew è il predefinito su Apple Silicon. /usr/local è il predefinito su Intel, e può anche contenere un vecchio Homebrew Rosetta su un Mac migrato. Controlla sempre brew --prefix prima di cancellare.

Dovrei disinstallare ogni formula prima di eseguire lo script di disinstallazione?

Solo se vuoi una pulizia a tappe o devi ispezionare prima i dati in var. Lo script rimuove già i pacchetti installati nel prefisso. Esporta comunque gli elenchi se potresti reinstallare più avanti.

Perché restano directory dopo la disinstallazione?

Permessi o directory che Homebrew non ha creato possono bloccare la cancellazione. Lo script stampa quei percorsi una sola volta. Rimuovili con sudo solo quando li riconosci come residui di Homebrew.

È sicuro cancellare tutto /usr/local?

No. Sui Mac Intel quella cartella è condivisa. Usa lo script ufficiale di disinstallazione, poi rimuovi solo i percorsi che nomina se resta qualcosa.

Vedo ancora errori di brew shellenv in ogni nuovo terminale. Cosa faccio?

Rimuovi la riga eval "$(...brew shellenv)" dai file di avvio di zsh o bash, poi apri una nuova scheda. Il disinstallatore non modifica quei file per te.