AskClean

Comment vider le cache Homebrew et supprimer les anciennes versions sur Mac

Équipe AskClean · Mis à jour 2026-11-02

Exécutez brew cleanup -n avant toute modification. Un brew cleanup normal retire les verrous obsolètes, les téléchargements périmés et les anciennes versions des formules installées ; sauf si HOMEBREW_NO_AUTOREMOVE est défini, il peut aussi désinstaller automatiquement les dépendances devenues inutiles. L’option -s (--scrub) va plus loin : elle supprime aussi les téléchargements en cache des dernières versions, par exemple ceux de paquets récupérés mais jamais installés, ou désinstallés depuis. Dans tous les cas, les téléchargements de ce qui est encore installé sont conservés. Vérifiez l’emplacement du cache avec brew --cache.

Étagères éclairées remplies de bouteilles et de boîtes, avec plusieurs bouteilles retirées dans un bac de recyclage
Le stockage Homebrew n’a pas un coût de récupération uniforme : prévisualisez téléchargements et anciennes versions, mais protégez les outils actuels et la configuration.

Distinguer cache, anciens kegs et outils actuels

Homebrew conserve les paquets binaires (bottles), les archives de code source et les téléchargements de casks sous ~/Library/Caches/Homebrew par défaut ; HOMEBREW_CACHE peut changer ce chemin. Les formules installées résident dans des répertoires versionnés appelés kegs dans le Cellar, les casks dans le Caskroom et les liens actifs sous le préfixe. Découvrez les vrais emplacements avec brew --cache, brew --cellar, brew --caskroom et brew --prefix. Le Cellar, le Caskroom, le préfixe, le Brewfile, les fichiers de configuration, les services, les bases de données et les projets ne sont pas un cache à supprimer en bloc.

Auditer chaque candidat avec une simulation

Mesurez le cache actif avec du -sh "$(brew --cache)", puis exécutez brew cleanup -n. La simulation montre les téléchargements périmés, mais aussi les anciennes formules installées et toute dépendance proposée à la suppression automatique. Vérifiez les outils dont vous dépendez avec brew list --versions et assurez-vous qu’aucun script ni retour à une version antérieure n’utilise encore un ancien keg. Une simulation n’est pas une sauvegarde : une fois retirés, les éléments n’arrivent pas forcément dans la Corbeille de macOS et ne restent pas forcément disponibles dans la même version à la source.

  1. Exécutez brew --cache, puis mesurez le cache de téléchargement actif avec du -sh "$(brew --cache)".
  2. Exécutez brew cleanup -n et examinez chaque téléchargement, chaque ancienne version de formule et toute dépendance proposée à la suppression automatique.
  3. Utilisez brew list --versions pour repérer les versions actuelles et anciennes dont vous avez besoin, puis vérifiez le réseau, le proxy et la disponibilité des paquets à la source.
  4. Lancez brew cleanup pour l’entretien normal après avoir accepté tous les candidats ; si vous voulez exclure autoremove, préfixez la simulation et la commande réelle par HOMEBREW_NO_AUTOREMOVE=1. N’utilisez brew cleanup -s ou brew cleanup --prune=all qu’après avoir contrôlé brew cleanup -n -s ou brew cleanup -n --prune=all, avec le même préfixe si nécessaire.
  5. Remesurez le cache, relancez brew cleanup -n et brew list --versions, puis testez au moins un outil Homebrew important.

brew cleanup -n est une prévisualisation, pas une sauvegarde. Un ancien keg supprimé peut casser un script qui pointe vers son chemin ou empêcher le retour à cette version, sans garantie de récupération à l’identique.

Choisir la commande cleanup la plus ciblée

Après examen, utilisez brew cleanup pour l’entretien normal, fondé sur l’âge des fichiers. Pour exclure la suppression automatique des dépendances inutilisées, préfixez la simulation et la commande réelle par HOMEBREW_NO_AUTOREMOVE=1, y compris avec -s ou --prune=all : par exemple HOMEBREW_NO_AUTOREMOVE=1 brew cleanup -n, puis HOMEBREW_NO_AUTOREMOVE=1 brew cleanup. L’option -s (--scrub) élargit le nettoyage aux téléchargements récents et supprime aussi ceux des dernières versions pour les paquets qui ne sont pas installés (récupérés sans être installés, ou désinstallés depuis), mais garde ceux des formules et casks encore installés ; -s veut dire --scrub, et non « safe » ou « silent », et ne vide pas tout le cache : prévisualisez avec brew cleanup -n -s. Si vous voulez vraiment retirer tous les fichiers en cache quel que soit leur âge, contrôlez d’abord brew cleanup -n --prune=all avant d’exécuter brew cleanup --prune=all. Les prochaines installations, réinstallations ou compilations depuis les sources devront récupérer de nouveau bottles, archives et installateurs, et cleanup peut aussi supprimer d’anciens kegs, ce qui rend impossible un retour exact à une version antérieure.

Distinguer autoremove du nettoyage du cache

brew autoremove n’est pas un nettoyage de cache : il désinstalle les formules que Homebrew juge désormais inutiles comme dépendances. Homebrew peut toutefois déclencher cette opération pendant brew cleanup, sauf si HOMEBREW_NO_AUTOREMOVE est défini. Pour prendre cette décision séparément, utilisez HOMEBREW_NO_AUTOREMOVE=1 avec la simulation puis la commande réelle, et examinez ensuite brew autoremove --dry-run à part, car vos scripts peuvent utiliser directement un outil non déclaré. Après cleanup, remesurez le cache, relancez brew cleanup -n et brew list --versions, puis testez vos commandes importantes.

Limites de suppression et coût de récupération

Videz le cache Homebrew sur Mac : prévisualisez avec brew cleanup -n, comprenez -s (--scrub) et --prune=all, et protégez outils actuels et configuration.

Élément ou actionÀ inspecter avec ou dansConséquence
Distinguer cache, anciens kegs et outils actuelsbrew --cacheHomebrew conserve les paquets binaires (bottles), les archives de code source et les téléchargements de casks sous ~/Library/Caches/Homebrew par défaut ; HOMEBREW_CACHE peut changer ce chemin.
Auditer chaque candidat avec une simulationbrew cleanup -nMesurez le cache actif avec du -sh "$(brew --cache)", puis exécutez brew cleanup -n.
Choisir la commande cleanup la plus cibléebrew cleanup / brew cleanup -s / brew cleanup --prune=allAprès examen, utilisez brew cleanup pour l’entretien normal, fondé sur l’âge des fichiers.
Distinguer autoremove du nettoyage du cachebrew autoremove --dry-run (ce n’est pas un nettoyage de cache)brew autoremove n’est pas un nettoyage de cache : il désinstalle les formules que Homebrew juge désormais inutiles comme dépendances.

FAQ

brew cleanup est-il sans risque sur Mac ?

C’est une commande Homebrew prise en charge, mais elle retire aussi d’anciennes versions de formules et peut déclencher autoremove. Exécutez toujours brew cleanup -n d’abord, protégez les kegs encore nécessaires à un script ou à un retour à une version antérieure, et utilisez HOMEBREW_NO_AUTOREMOVE=1 si vous voulez traiter les dépendances inutilisées séparément.

Que suppriment brew cleanup -s et brew cleanup --prune=all ?

--prune=all retire les fichiers en cache quel que soit leur âge ; -s (--scrub) supprime aussi les téléchargements en cache des dernières versions pour les paquets qui ne sont pas installés, par exemple récupérés sans jamais être installés ou désinstallés depuis, mais conserve ceux des formules et casks encore installés. Dans les deux cas, cleanup retire aussi les verrous obsolètes et les anciennes versions de formules. Vérifiez la liste exacte avec brew cleanup -n -s ou brew cleanup -n --prune=all.

Faut-il ensuite exécuter brew autoremove ?

Pas comme étape supplémentaire automatique. brew autoremove désinstalle des formules de dépendance et ne vide pas le cache ; brew cleanup peut déjà le déclencher, sauf si HOMEBREW_NO_AUTOREMOVE est défini. Pour une décision séparée, utilisez cette variable pendant cleanup, puis commencez par brew autoremove --dry-run.

Sources

Poursuivre le nettoyage du stockage de développement