Apagar o cache do Homebrew é seguro. ~/Library/Caches/Homebrew guarda downloads e metadados, e os pacotes instalados ficam no Cellar, que o cache não toca. Antes de mexer na pasta, pergunte ao brew cleanup o que ele removeria. O Homebrew enxuga o cache sozinho, e no meu Mac a pasta inteira ocupava 527 MB, contra 2,1 GB de fórmulas instaladas.
Regra principal: rode todo comando de limpeza primeiro com -n. Ele mostra o que removeria e quanto espaço isso libera.
Resposta rápida
- Encontre a pasta com
brew --cache. - Rode
brew cleanup -npara ver o que uma limpeza de rotina remove. - Rode
brew cleanup --prune=all -npara ver quanto libera limpar o cache inteiro. - Rode o comando escolhido sem
-n. - Rode
brew autoremove -npara achar dependências de que nada mais precisa. - Deixe o Cellar por conta do
brew uninstall.
O que fica no cache
Medi o cache em 25 de outubro de 2026 no meu Mac, com Homebrew 7.0.10:
Dentro de ~/Library/Caches/Homebrew | O que guarda | No meu Mac |
|---|---|---|
downloads | bottles, arquivos de código-fonte compactados e instaladores de casks | 484 MB |
api | metadados de fórmulas e casks da API JSON do Homebrew | 30 MB |
bootsnap | um cache de carregamento que acelera o próprio brew | 13 MB |
As fórmulas instaladas ficam em outro lugar, no Cellar, dentro de brew --prefix. No Apple silicon, isso é /opt/homebrew/Cellar, e no meu Mac ocupava 2,1 GB. Os logs do Homebrew ficam em ~/Library/Logs/Homebrew.
O que o Homebrew já limpa
A manpage do brew descreve duas regras automáticas:
brew install,brew upgradeebrew reinstallrodam obrew cleanuppara os pacotes que tocam, e a cada 30 dias para todos os pacotes. DefinirHOMEBREW_NO_INSTALL_CLEANUPdesliga isso.- O
brew cleanupremove downloads com mais de 120 dias.HOMEBREW_CLEANUP_MAX_AGE_DAYSmuda esse número.
Uma limpeza também remove downloads desatualizados, arquivos de lock abandonados e versões antigas de fórmulas instaladas. Essa última parte libera espaço no Cellar, que muitas vezes é onde está a economia maior.
No meu Mac, o brew cleanup -n não encontrou nada para remover, porque a limpeza automática já tinha feito o trabalho de rotina. O brew cleanup --prune=all -n informou que liberaria cerca de 507 MB.
O que muda ao apagar o cache
- Os pacotes instalados ficam. O
brew listmostra as mesmas fórmulas e casks depois. - Reinstalações baixam de novo. Reinstalar ou atualizar um pacote busca o bottle ou o instalador na rede.
- Os instaladores de casks vão embora. Os arquivos
.dmge.pkgque os casks baixaram saem junto com o cache. - O brew recria a pasta. O próximo download a cria de novo.
Os comandos, do mais leve ao completo
brew cleanup -n # what a routine cleanup would remove
brew cleanup # remove it
brew cleanup --prune=all -n # what removing every cached file would free
brew cleanup --prune=all # remove it
O brew cleanup -s, a opção de scrub, também remove os downloads das versões mais recentes. Os downloads das fórmulas e casks que você tem instalados continuam lá, e a manpage indica rm -rf "$(brew --cache)" se você quiser se livrar deles também. Mover a pasta para o Lixo no Finder tem o mesmo efeito e deixa um caminho de volta.
O brew autoremove -n cuida de outro tipo de sobra: fórmulas instaladas só como dependências de algo que você já removeu. Ele libera espaço no Cellar, não no cache.
Quando o problema não é o cache
Se o cache tem algumas centenas de megabytes, o espaço que você procura está em outro lugar. Confira o Cellar com du -sh "$(brew --prefix)/Cellar" e desinstale o que não usa mais. Depois olhe as pastas de desenvolvedor que costumam ser muito maiores que o Homebrew: o DerivedData do Xcode, os simuladores e caches de pacotes como o do SwiftPM.
Conclusão
Limpar o cache do Homebrew não quebra nada, e a pasta raramente fica grande, porque o Homebrew a enxuga a cada 30 dias. Use brew cleanup -n para ver o que sobrou, --prune=all quando quiser a pasta vazia e brew autoremove para dependências de que nada precisa. Os pacotes instalados ficam onde estão o tempo todo.
Perguntas frequentes
É seguro apagar ~/Library/Caches/Homebrew?
Sim. O cache guarda downloads, metadados da API e o cache de carregamento do próprio brew. Os pacotes instalados ficam no Cellar, dentro de brew --prefix, e continuam onde estão. O único custo é que uma reinstalação ou atualização baixa os arquivos de novo.
O brew cleanup apaga pacotes instalados?
Não. Ele remove downloads desatualizados, arquivos de lock abandonados e versões antigas de fórmulas instaladas. A versão atual de tudo o que você instalou fica.
Com que frequência o Homebrew limpa o cache sozinho?
brew install, brew upgrade e brew reinstall rodam uma limpeza para os pacotes que tocam, e a cada 30 dias para todos os pacotes, a menos que HOMEBREW_NO_INSTALL_CLEANUP esteja definida. Por padrão, uma limpeza remove downloads com mais de 120 dias, prazo definido por HOMEBREW_CLEANUP_MAX_AGE_DAYS.
Como limpo o cache inteiro do Homebrew?
Rode brew cleanup --prune=all -n para ver o que ele removeria e quanto espaço libera, depois rode de novo sem -n. No meu Mac, ele informou cerca de 507 MB, de uma pasta de 527 MB.
Onde fica o cache do Homebrew no Mac?
Rode brew --cache. No macOS, ele mostra ~/Library/Caches/Homebrew. As fórmulas instaladas ficam no Cellar, que é /opt/homebrew/Cellar no Apple silicon.