Voltar ao blog

É seguro apagar o cache do Homebrew no Mac?

O que ~/Library/Caches/Homebrew guarda, por que apagá-lo nunca desinstala nada, o que o brew cleanup já remove sozinho e os comandos para limpar o resto.

Publicado 25 de outubro de 2026 Autor Vladimir Chemeris Tempo de leitura 4 min de leitura
HomebrewCachesDeveloper Cleanup

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

  1. Encontre a pasta com brew --cache.
  2. Rode brew cleanup -n para ver o que uma limpeza de rotina remove.
  3. Rode brew cleanup --prune=all -n para ver quanto libera limpar o cache inteiro.
  4. Rode o comando escolhido sem -n.
  5. Rode brew autoremove -n para achar dependências de que nada mais precisa.
  6. 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/HomebrewO que guardaNo meu Mac
downloadsbottles, arquivos de código-fonte compactados e instaladores de casks484 MB
apimetadados de fórmulas e casks da API JSON do Homebrew30 MB
bootsnapum cache de carregamento que acelera o próprio brew13 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 upgrade e brew reinstall rodam o brew cleanup para os pacotes que tocam, e a cada 30 dias para todos os pacotes. Definir HOMEBREW_NO_INSTALL_CLEANUP desliga isso.
  • O brew cleanup remove downloads com mais de 120 dias. HOMEBREW_CLEANUP_MAX_AGE_DAYS muda 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 list mostra 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 .dmg e .pkg que 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.

Sobre o autor

Vladimir Chemeris

Fundador, StorageRadar

Vladimir Chemeris desenvolve o StorageRadar, um app de macOS para análise de armazenamento com foco em privacidade, limpeza com revisão prévia, armazenamento de desenvolvedor e comparação antes e depois.

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.

Fontes e referências

Veja cada cache de pacotes com o tamanho dele.

O Dev Cleanup do StorageRadar mede os caches do Homebrew, npm, pnpm, Yarn, pip e SwiftPM ao lado das pastas do Xcode, classifica cada um por risco e mostra o resultado de um Dry Run antes da limpeza.