Caches do JetBrains no Mac (IntelliJ, WebStorm, PyCharm)

IDEs da JetBrains, como IntelliJ IDEA, WebStorm e PyCharm, guardam no Mac várias pastas de vários gigabytes, e só algumas podem ser limpas com segurança. Caches e índices são recriados na próxima abertura; configuração, plugins e dados de projeto, não. Essa diferença é o que impede uma limpeza de virar ajuste perdido ou projeto quebrado.

Esta página acompanha o guia geral de caches de desenvolvimento, só para o JetBrains. "Mole" aqui é só o Mole para Mac em mole.fit e a ferramenta de linha de comando mo. Não há números de gigabytes por IDE, porque variam demais para servir de referência; meça na sua máquina.

O que o JetBrains guarda, e o que não é só cache

Uma instalação do JetBrains são várias pastas, com custos de recuperação bem diferentes. Tratar tudo como uma pasta só é onde as limpezas dão errado.

Caches e índices se recriam sozinhos. Os registros não voltam, mas você pode descartá-los quando terminar o diagnóstico. As três últimas camadas são a sua configuração e o seu trabalho, e não são cache, em qualquer pasta que estejam.

Prefira as ferramentas da própria IDE

Antes de apagar qualquer pasta, use o caminho que a IDE já oferece. Arquivo › Invalidate Caches limpa caches e índices e oferece reiniciar, que é o jeito suportado de corrigir um índice velho sem mexer nos ajustes. Confira o texto exato do menu na sua versão atual do IntelliJ, do WebStorm ou do PyCharm, porque os rótulos mudam entre versões.

Versões antigas costumam ser onde está a maior parte do espaço. Cada versão principal da IDE guarda o próprio conjunto de pastas, e uma atualização deixa o conjunto anterior para trás. Ajuda › Delete Leftover IDE Directories… procura pastas de ajustes, cache e registros de versões anteriores da IDE e deixa você escolher o que apagar; versões que ainda estão instaladas começam sem seleção. As builds atuais da IntelliJ Platform também fazem parte dessa limpeza sozinhas, cerca de uma semana depois de uma atualização: para versões sem uso há 180 dias, apagam a pasta de sistema (caches, índices e o Local History daquela versão) e os registros, e mantêm ajustes e plugins.

Feche a IDE antes de revisar qualquer pasta na mão, para não apagar arquivos que o processo em execução ainda mantém abertos.

Achar a pasta de sistema no Mac

A JetBrains documenta a localização das pastas por versão, e a subpasta exata de produto e versão muda em cada máquina. Localize a sua pela IDE (Ajuda › Show Log in Finder abre a pasta de registros) em vez de colar um caminho absoluto desatualizado. Nas versões atuais, as pastas pai no macOS são ~/Library/Caches/JetBrains e ~/Library/Application Support/JetBrains, com os registros em ~/Library/Logs/JetBrains.

Meça as pastas pai para ver para onde o espaço vai de fato, antes de remover qualquer coisa:

du -sh ~/Library/Caches/JetBrains ~/Library/Application\ Support/JetBrains ~/Library/Logs/JetBrains

Isso mostra quanto está na pasta de sistema, na pasta de configuração e nos registros. Uma linha "No such file or directory" só significa que essa pasta não existe neste Mac. A pasta de sistema também contém o Local History, então o total dela não é todo cache descartável. Application Support guarda ajustes e plugins.

Uma ordem segura

1. Meça as pastas pai do JetBrains para saber onde está o espaço.
2. Rode Arquivo › Invalidate Caches, deixe desmarcada a remoção opcional do Local History e reinicie a IDE.
3. Meça de novo quando a reindexação terminar. O índice é recriado, então parte do espaço volta.
4. Para versões antigas, use Ajuda › Delete Leftover IDE Directories… em vez de apagar pastas na mão; remova registros antigos só quando o diagnóstico tiver acabado.
5. Nunca apague .idea nem o Local History por impulso; isso é trabalho do projeto e seu.

A sobreposição com gerenciadores de pacotes e pastas soltas de node_modules fica em outro guia: como limpar caches de desenvolvimento no Mac cobre npm, Cargo, pip e Gradle, e como limpar o Xcode cobre o DerivedData se você também compila com a cadeia de ferramentas da Apple. Uma IDE não é um JDK, então remover um runtime é uma tarefa à parte em desinstalar o Java no Mac.

Quando um mapa de disco ajuda

Quando você já sabe que as pastas do JetBrains são grandes, um mapa de disco ajuda a ver qual produto e qual versão ocupam o espaço. A Análise do Mole mostra pastas grandes com caminho e tamanho; a análise é gratuita sem licença, e você decide o que remover. A Limpeza do Mole deixa de propósito ~/Library/Caches/JetBrains, ~/Library/Application Support/JetBrains e ~/Library/Caches/com.jetbrains.toolbox de fora, porque guardam Local History e ajustes ao lado dos caches. As ferramentas da própria IDE continuam sendo o jeito de limpá-los. Quando você desinstala uma IDE da JetBrains no Mole, as pastas com o nome da versão aparecem na lista, mas não vêm selecionadas, e a mesma proteção mantém as que estão em Caches e Application Support. Confira e remova você mesmo se não precisar mais dos ajustes ou do Local History daquela IDE.

Isso é um trabalho diferente do mo purge, que varre a saída de build dos projetos e as pastas de dependências, e não os caches da IDE, como explica o que é o purge no Mac. Para o que o Mole revisa e o que se recusa a tocar, veja o Mole é seguro.

Leitura adicional

• Como limpar caches de desenvolvimento no Mac: o lado dos gerenciadores de pacotes e do node_modules.
• Quais caches do Mac dá para apagar: a regra geral do que se recria e do que não se recria.
• O Mole é seguro: o que uma ferramenta de revisar antes de apagar remove e o que não remove.

Perguntas frequentes

Limpar os caches apaga os meus projetos?

A ação padrão de Invalidate Caches não apaga os arquivos do projeto nem o Local History. O Local History fica dentro da pasta de sistema da IDE, e o diálogo tem uma opção separada que o apaga. Deixe essa opção desmarcada.

Invalidate Caches ou apagar a pasta de sistema?

Invalidate Caches é o caminho suportado: limpa caches e índices na reinicialização, sem remover ajustes nem plugins, e mantém o Local History a menos que você marque a opção de remoção. Apagar a pasta de sistema inteira na mão pode apagar o Local History. Ajustes e plugins normalmente ficam em Application Support, não nessa pasta de sistema.

Várias IDEs ou o Toolbox: uma limpeza ou uma por produto?

Cada produto e cada versão guarda a própria subpasta, então os caches se acumulam por produto e por versão. Limpe por produto, em cada IDE, use Ajuda › Delete Leftover IDE Directories… para versões que você não executa mais e meça as pastas pai do JetBrains para ver qual instalação está grande de fato antes de remover qualquer coisa.