# Nettoyer Homebrew : comment libérer l’espace que brew occupe sur votre Mac

> Ce que brew cleanup supprime et garde, comment vider le cache, retirer dépendances orphelines et anciennes versions, et mesurer l’empreinte de Homebrew.

- URL: https://moreroom.app/fr/learn/homebrew-cleanup
- Published: 2026-10-17
- Updated: 2026-10-17
- Publisher: MoreRoom (Yando Pte. Ltd.) — https://moreroom.app

## TL;DR

- brew cleanup supprime les anciennes versions des formules installées, les fichiers de verrouillage obsolètes et, par défaut, les téléchargements de plus de 120 jours.
- brew cleanup --prune=all supprime aussi tous les téléchargements en cache, quel que soit leur âge ; lancez d’abord brew cleanup -n pour un aperçu.
- brew autoremove désinstalle les dépendances dont plus aucune formule installée n’a besoin.
- Homebrew se trouve dans /opt/homebrew sur Apple silicon et dans /usr/local sur les Mac Intel ; son cache de téléchargement est dans ~/Library/Caches/Homebrew.
- brew uninstall --zap supprime une app installée en cask avec ses réglages et fichiers de support, parmi lesquels peuvent figurer des fichiers partagés avec d’autres apps.

Homebrew garde les anciennes versions de ce que vous mettez à jour et un cache de ce qu’il télécharge : il grossit donc peu à peu. **`brew cleanup` supprime les anciennes versions et les téléchargements de plus de 120 jours ; `brew cleanup --prune=all` vide entièrement le cache de téléchargement ; `brew autoremove` désinstalle les dépendances dont plus rien n’a besoin.** Ce sont trois commandes officielles, et aucune ne touche à la version actuelle de ce que vous utilisez.

Les commandes et valeurs par défaut ci-dessous sont tirées du [manuel de Homebrew](https://docs.brew.sh/Manpage), à jour en octobre 2026 (Homebrew 7).

## Où Homebrew range ses fichiers

| Quoi | Apple silicon | Intel |
|---|---|---|
| Préfixe (`brew --prefix`) | `/opt/homebrew` | `/usr/local` |
| Formules installées (`brew --cellar`) | `/opt/homebrew/Cellar` | `/usr/local/Cellar` |
| Casks (`brew --caskroom`) | `/opt/homebrew/Caskroom` | `/usr/local/Caskroom` |
| Cache de téléchargement (`brew --cache`) | `~/Library/Caches/Homebrew` | `~/Library/Caches/Homebrew` |

macOS 27 Golden Gate ne fonctionne que sur Apple silicon : les nouvelles installations utilisent donc `/opt/homebrew`. Les Mac Intel, qui restent sous macOS 26 Tahoe ou une version antérieure, continuent d’utiliser `/usr/local`. Un Mac migré depuis un modèle Intel peut avoir les deux ; `brew --prefix` indique lequel est actif.

Les apps installées en cask se trouvent dans `/Applications`, comme n’importe quelle autre app.

![Comment le cache de téléchargement, le Cellar et les casks de Homebrew correspondent aux commandes de nettoyage](https://moreroom.app/learn/img/homebrew-cleanup-anatomy.svg)

## Mesurer avant de nettoyer

```sh
du -sh "$(brew --cache)"
du -sh "$(brew --cellar)"
du -sh "$(brew --cellar)"/* | sort -h | tail -20
```

Les deux premières lignes affichent la taille du cache de téléchargement et de l’ensemble des formules installées. La troisième liste les 20 formules les plus volumineuses. Chaque dossier du Cellar contient un sous-dossier par version installée : `brew list --versions` montre donc quelles formules en ont plusieurs.

## brew cleanup : ce qu’il supprime et ce qu’il garde

```sh
brew cleanup -n
brew cleanup
```

`brew cleanup -n` (ou `--dry-run`) liste chaque fichier qu’il supprimerait et se termine par une estimation de l’espace libéré. Rien n’est effacé. `brew cleanup` seul, ensuite :

- supprime les **anciennes versions** des formules installées, en gardant la version actuelle ;
- supprime les **fichiers de verrouillage obsolètes** et les **téléchargements périmés** des formules et des casks ;
- supprime **tout téléchargement de plus de 120 jours**. `HOMEBREW_CLEANUP_MAX_AGE_DAYS` modifie ce nombre.

Par défaut, il supprime aussi les dépendances devenues inutiles, comme `brew autoremove`, sauf si vous avez défini `HOMEBREW_NO_AUTOREMOVE`.

Pour ne nettoyer qu’une formule ou un cask, indiquez son nom : `brew cleanup node`.

### Aller plus loin avec --prune

```sh
brew cleanup --prune=all
```

`--prune` prend un nombre de jours et supprime tous les fichiers en cache plus anciens ; `--prune=all` les supprime quel que soit leur âge. `-s` (`--scrub`) supprime aussi les téléchargements des dernières versions, tout en gardant ceux des formules et casks actuellement installés. L’aide de Homebrew précise que `rm -rf "$(brew --cache)"` supprime même ces derniers. Le cache ne contient que des téléchargements : toutes ces options sont donc sans risque, Homebrew retélécharge ce dont il a besoin.

Toutes ces suppressions sont définitives : rien ne passe par la corbeille.

### Le nettoyage automatique

Homebrew fait déjà en partie le ménage derrière lui. Après `brew install`, `brew upgrade` et `brew reinstall`, il lance un nettoyage des formules concernées, et tous les 30 jours (`HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS`) un nettoyage de l’ensemble. Si vous avez défini `HOMEBREW_NO_INSTALL_CLEANUP` dans votre profil de shell, cela n’arrive jamais, ce qui explique un Cellar rempli d’anciennes versions. Retirez la variable ou lancez vous-même `brew cleanup` de temps en temps. Pour protéger certaines formules, listez-les dans `HOMEBREW_NO_CLEANUP_FORMULAE`.

## Retirer les dépendances dont plus rien n’a besoin

Quand vous désinstallez une formule, les bibliothèques qu’elle avait installées peuvent rester.

```sh
brew autoremove -n
brew autoremove
```

`brew autoremove` désinstalle les formules installées uniquement comme dépendances et dont plus rien n’a besoin. La version `-n` affiche d’abord la liste.

## Désinstaller ce que vous n’utilisez plus

```sh
brew leaves --installed-on-request
brew uninstall <formula>
```

`brew leaves` liste les formules dont rien d’autre ne dépend, et `--installed-on-request` (`-r`) limite la liste à celles que vous avez installées vous-même. C’est généralement la liste la plus courte à passer en revue. Désinstaller une formule la retire définitivement du Cellar ; la réinstaller la retélécharge.

### Les casks et --zap

```sh
brew uninstall --cask <cask>
brew uninstall --zap <cask>
```

Une désinstallation normale supprime l’app. `--zap` supprime aussi les fichiers que la définition du cask attribue à l’app, comme les préférences, les caches et les dossiers de support dans `~/Library`. Le manuel de Homebrew prévient que l’option **peut supprimer des fichiers partagés entre applications** : réservez-la aux apps dont vous êtes sûr de vouloir vous débarrasser avec leurs réglages. Pour les apps qui n’ont pas été installées avec Homebrew, voir [comment désinstaller complètement une app Mac](https://moreroom.app/learn/uninstall-mac-apps-completely).

### Avant de désinstaller, vérifiez ce qui en dépend

```sh
brew uses --installed <formula>
```

Cette commande liste les formules et casks installés qui ont besoin de celle que vous vous apprêtez à supprimer. Si la liste n’est pas vide, Homebrew refuse la désinstallation, sauf si vous ajoutez `--ignore-dependencies`, ce qui peut casser ces paquets. Mieux vaut en général laisser les bibliothèques partagées tranquilles et laisser `brew autoremove` s’en charger quand plus rien n’en a besoin.

## Pourquoi Homebrew peut rester volumineux après un nettoyage

Un nettoyage supprime les restes, pas les paquets que vous utilisez. Les chaînes de compilation, compilateurs et gros frameworks sont volumineux par nature, et chacun peut entraîner des dizaines de dépendances. Si le Cellar reste gros, la troisième commande `du` ci-dessus montre quelles formules dominent. Désinstallez celles dont vous n’avez plus besoin, puis lancez `brew autoremove` pour que leurs dépendances suivent.

## Vérifier le résultat

```sh
brew doctor
```

`brew doctor` recherche d’éventuels problèmes dans votre installation et se termine sur une erreur s’il en trouve. La plupart des avertissements sont purement informatifs, mais c’est une bonne dernière étape après un nettoyage ou une migration vers un nouveau Mac.

## Comment MoreRoom vous aide

La version gratuite de MoreRoom reconnaît le cache de téléchargement et le Cellar de Homebrew et affiche leur taille. Le cache de téléchargement est marqué « Sans risque » et le Cellar « À vérifier ». Quand vous nettoyez l’un ou l’autre, MoreRoom exécute la commande officielle de Homebrew, `brew cleanup --prune=all`, qui supprime les anciennes versions et les téléchargements en cache mais jamais les paquets que vous utilisez. Cette commande est définitive et signalée comme telle. MoreRoom ne désinstalle pas de formules ni de casks à votre place ; utilisez `brew uninstall` pour cela.

Pro ajoute le Collecteur, pour nettoyer plusieurs éléments d’un coup, et le mode objectif, qui choisit la sélection la plus sûre pour l’espace dont vous avez besoin.

## FAQ

### brew cleanup est-il sans risque ?

Oui. Il ne supprime que les anciennes versions des formules dont une version plus récente est installée, les fichiers de verrouillage obsolètes et les anciens téléchargements en cache. Les versions actuelles de tout ce que vous avez installé restent en place et continuent de fonctionner.

### Homebrew fait-il le ménage automatiquement ?

En partie. Après brew install, upgrade ou reinstall, il nettoie les formules concernées, et tous les 30 jours il lance un nettoyage complet. La variable HOMEBREW_NO_INSTALL_CLEANUP désactive ce comportement.

### Puis-je supprimer ~/Library/Caches/Homebrew ?

Oui. Il ne contient que des téléchargements, que Homebrew récupère de nouveau au besoin. brew cleanup --prune=all est la méthode propre ; l’aide de Homebrew mentionne rm -rf "$(brew --cache)" pour supprimer même les téléchargements des paquets installés.

### Quelle différence entre brew autoremove et brew cleanup ?

brew cleanup supprime les anciennes versions et les téléchargements en cache de ce que vous utilisez encore. brew autoremove désinstalle des formules entières, installées uniquement comme dépendances et dont plus rien n’a besoin.

### Où Homebrew est-il installé sur mon Mac ?

Dans /opt/homebrew sur les Mac avec puce Apple et dans /usr/local sur les Mac Intel. Exécutez brew --prefix pour voir le vôtre.
