Les caches JetBrains sur Mac (IntelliJ, WebStorm, PyCharm)

Les IDE JetBrains comme IntelliJ IDEA, WebStorm et PyCharm laissent plusieurs répertoires de plusieurs gigaoctets sur un Mac, et seuls certains sont sûrs à vider. Les caches et les index se reconstruisent au prochain lancement ; la configuration, les plug-ins et les données de projet, non. Cette différence empêche un nettoyage de se transformer en réglages perdus ou en projet cassé.

Cette page est le complément propre à JetBrains du guide général des caches de développement. Elle emploie « Mole » uniquement pour Mole for Mac sur mole.fit et son propre outil en ligne de commande mo, et ne cite pas de chiffres en gigaoctets par IDE, car ils varient trop pour être utiles ; vous mesurez sur votre propre machine.

Ce que JetBrains stocke, et ce qui n'est pas seulement du cache

Une installation JetBrains, ce sont plusieurs répertoires aux coûts de récupération très différents. Les traiter comme un seul dossier, c'est là que les nettoyages tournent mal.

Les caches et les index se reconstruisent seuls. Les journaux ne reviennent pas, mais vous pouvez les jeter une fois le dépannage terminé. Les trois dernières couches sont votre configuration et votre travail, et ce n'est pas du cache, quel que soit le dossier où elles se trouvent.

Préférez les outils propres à l'IDE

Avant de supprimer un dossier, utilisez le chemin intégré de l'IDE. File › Invalidate Caches vide les caches et les index et propose de redémarrer, c'est la façon prise en charge de réparer un index périmé sans toucher aux réglages. Confirmez le libellé exact du menu dans votre version actuelle d'IntelliJ, WebStorm ou PyCharm, car les libellés changent d'une version à l'autre.

Ce sont généralement les anciennes versions qui occupent le plus d'espace. Chaque version majeure de l'IDE a son propre jeu de dossiers, et une mise à niveau laisse l'ancien jeu en place. Help › Delete Leftover IDE Directories… recherche les répertoires de réglages, de cache et de journaux des versions précédentes de l'IDE et vous laisse choisir lesquels supprimer ; les versions encore installées sont décochées au départ. Les builds actuels de la plateforme IntelliJ font aussi une partie de ce nettoyage d'eux-mêmes, environ une semaine après une mise à niveau : pour les versions inutilisées depuis 180 jours, ils suppriment le dossier système (caches, index et Local History de cette version) ainsi que les journaux, et gardent les réglages et les plug-ins.

Quittez l'IDE avant de passer un dossier en revue à la main, pour ne pas supprimer des fichiers que le processus en cours garde ouverts.

Trouver le répertoire système sur Mac

JetBrains documente l'emplacement de ses répertoires par version, et le sous-dossier exact produit-et-version diffère sur chaque machine ; localisez donc le vôtre via l'IDE (Help › Show Log in Finder ouvre le dossier des journaux) plutôt que de coller un chemin absolu périmé. Sur les versions actuelles, les dossiers parents sur macOS sont ~/Library/Caches/JetBrains et ~/Library/Application Support/JetBrains, avec les journaux dans ~/Library/Logs/JetBrains.

Mesurez les parents pour voir où part réellement l'espace avant de retirer quoi que ce soit :

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

Vous voyez ainsi ce qu'occupent le répertoire système, le répertoire de configuration et les journaux. Une ligne « No such file or directory » signifie seulement que ce dossier n'existe pas sur ce Mac. Le total sous Caches comprend aussi Local History : ce n'est donc pas uniquement du cache jetable. Les réglages et les plug-ins se trouvent sous Application Support.

Un ordre sûr

1. Mesurez les dossiers parents JetBrains pour savoir où est l'espace.
2. Lancez File › Invalidate Caches sans cocher l'option supplémentaire qui efface Local History, puis redémarrez l'IDE.
3. Mesurez de nouveau une fois la réindexation terminée. L'index est reconstruit, donc une partie de l'espace revient.
4. Pour les anciennes versions, utilisez Help › Delete Leftover IDE Directories… plutôt que de supprimer des dossiers à la main ; n'effacez les anciens journaux qu'une fois le dépannage terminé.
5. Ne supprimez jamais .idea ou Local History à la légère ; c'est du travail de projet et personnel.

Le recouvrement avec les gestionnaires de paquets et les dossiers node_modules éparpillés relève d'un autre guide : comment vider les caches de développement sur Mac couvre npm, Cargo, pip et Gradle, et comment nettoyer Xcode couvre DerivedData si vous compilez aussi avec la chaîne d'outils d'Apple. Un IDE n'est pas un JDK, donc retirer un runtime est une tâche distincte dans désinstaller Java sur Mac.

Quand une carte du disque aide

Une fois que vous savez que les dossiers JetBrains sont volumineux, une carte du disque sert à voir quel produit et quelle version occupent l'espace. La vue Analyze de Mole affiche les grands répertoires avec leur chemin et leur taille ; l'analyse est gratuite sans licence, et c'est vous qui décidez quoi retirer. Clean dans Mole laisse délibérément de côté ~/Library/Caches/JetBrains, ~/Library/Application Support/JetBrains et ~/Library/Caches/com.jetbrains.toolbox, car ils contiennent Local History et des réglages à côté des caches ; pour les vider, les outils propres à l'IDE restent la bonne voie. Quand vous désinstallez un IDE JetBrains dans Mole, ses dossiers nommés d'après la version sont listés mais non cochés, et la même protection laisse en place ceux qui se trouvent sous Caches et Application Support ; vérifiez-les et supprimez-les vous-même si vous n'avez plus besoin des réglages ou de la Local History de cet IDE.

C'est une tâche différente de mo purge, qui balaie les sorties de compilation et les dossiers de dépendances des projets plutôt que les caches de l'IDE, comme l'explique la purge sur Mac. Pour ce que Mole relit et ce qu'il refuse de toucher, voir Mole est-il sûr.

Pour aller plus loin

• Comment vider les caches de développement sur Mac : le côté gestionnaires de paquets et node_modules.
• Quels caches Mac peut-on supprimer sans risque : la règle générale reconstructible ou non.
• Mole est-il sûr : ce qu'un outil de relecture avant suppression retire ou non.

FAQ

Vider les caches va-t-il supprimer mes projets ?

Non. L'action normale Invalidate Caches ne supprime ni les fichiers du projet ni Local History. Local History se trouve toutefois dans le répertoire système, et une option distincte du dialogue peut l'effacer. Ne cochez pas cette option.

Invalidate Caches ou supprimer le répertoire système ?

Invalidate Caches est la voie prise en charge : il vide les caches et les index au redémarrage sans retirer les réglages ni les plug-ins, et conserve Local History, sauf si vous choisissez expressément de l'effacer. Supprimer à la main tout le répertoire système peut faire perdre Local History. Les réglages et les plug-ins se trouvent normalement sous Application Support, pas dans ce répertoire système.

Plusieurs IDE ou Toolbox : un seul nettoyage ou par produit ?

Chaque produit et version garde son propre sous-dossier, donc les caches s'accumulent par produit et par version. Nettoyez-les par produit via chaque IDE, utilisez Help › Delete Leftover IDE Directories… pour les versions que vous n'utilisez plus, et mesurez les dossiers parents JetBrains pour voir quelle installation est réellement volumineuse avant de retirer quoi que ce soit.