SpaceBroom Kaufen

node_modules und Paket-Caches auf dem Mac aufräumen

Aktualisiert am

Kurz gesagt: Paketmanager, also Programme wie npm, pip oder Homebrew, die Software-Bausteine herunterladen und installieren, legen jeden Download in einem Cache ab, einem Zwischenspeicher für den nächsten Gebrauch. Dazu hat jedes JavaScript-Projekt seinen eigenen Ordner node_modules mit allen Paketen, die es braucht. Beides lässt sich neu herunterladen, darum kannst du es aufräumen; die nächste Installation dauert dann länger. Am meisten bringen meist die node_modules ruhender Projekte, alte Homebrew-Versionen und ungenutzte Docker-Daten. Für Homebrew und Docker nimmst du die Befehle der Werkzeuge selbst, nicht den Finder.

Wie finde ich große node_modules-Ordner?

Am schnellsten mit einem Befehl im Terminal, dem Programm für Textbefehle unter Programme > Dienstprogramme. Er listet alle node_modules-Ordner in deinem Benutzerordner mit ihrer Größe, die größten unten:

find ~ -type d -name node_modules -prune -exec du -sh {} + 2>/dev/null | sort -h

Der Befehl liest nur und kann bei vielen Dateien einige Minuten brauchen. Dank -prune sucht er nicht in einem gefundenen node_modules weiter und zählt die verschachtelten Ordner darin deshalb nicht doppelt. Bei Projekten, an denen du gerade nicht arbeitest, kannst du den Ordner node_modules löschen. npm install im Projektordner stellt ihn wieder her; liegt dort eine package-lock.json, installiert npm ci genau die Versionen, die darin festgehalten sind. Nutzt das Projekt Yarn oder pnpm, nimm yarn install oder pnpm install. Lösche nie die package.json oder die Lock-Datei, denn aus ihnen entsteht node_modules neu.

Wo liegen die Caches von npm, Yarn und pnpm?

  • npm speichert Pakete unter ~/.npm/_cacache. npm cache verify prüft den Cache und entfernt Daten, die nicht mehr gebraucht werden; npm cache clean --force leert ihn ganz. Laut der Dokumentation von npm repariert sich der Cache selbst, das Leeren ist nur nötig, um Platz zu schaffen. Von allein löscht npm nichts, der Cache wächst mit jeder neuen Installation.
  • Yarn 1 nutzt auf dem Mac ~/Library/Caches/Yarn; yarn cache dir zeigt den genauen Ort, yarn cache clean leert ihn. Yarn 4 legt seinen Cache standardmäßig unter ~/.yarn/berry/cache ab, Yarn 2 und 3 dagegen im Projekt selbst unter .yarn/cache.
  • pnpm hält alle Pakete in einem gemeinsamen Speicher, auf dem Mac unter ~/Library/pnpm/store; pnpm store path zeigt den genauen Ort. Die Dateien in den Projekten sind Klone oder Hardlinks dieses Speichers und belegen den Platz nicht doppelt. Den Speicher zu leeren gibt deshalb vor allem frei, was kein Projekt mehr nutzt. Genau das entfernt pnpm store prune; laut pnpm hat der Befehl keine Nebenwirkungen auf deine Projekte.

Wie räume ich die Caches von pip, Go, Cargo und Gradle auf?

pip, der Paketmanager von Python, legt Downloads unter ~/Library/Caches/pip ab. pip3 cache info zeigt die Größe, pip3 cache purge leert den Cache; bei manchen Installationen heißt der Befehl pip statt pip3. Go legt seinen Build-Cache unter ~/Library/Caches/go-build ab, löscht Einträge, die fünf Tage nicht genutzt wurden, selbst und leert ihn ganz mit go clean -cache. Cargo, der Paketmanager von Rust, speichert heruntergeladene Pakete unter ~/.cargo/registry; laut Cargo-Dokumentation lässt sich jeder Teil davon entfernen, Cargo lädt Fehlendes neu. Gradle hält Abhängigkeiten und Build-Caches unter ~/.gradle/caches und löscht laut seiner Dokumentation selbst, was 30 Tage (bei manchen Caches 7 Tage) nicht genutzt wurde.

Wie räume ich Homebrew auf?

brew cleanup --dry-run zeigt, was Homebrew entfernen würde, ohne etwas zu löschen. brew cleanup entfernt dann alte Versionen installierter Formeln (so heißen die Pakete bei Homebrew) und veraltete Downloads; Downloads, die älter als 120 Tage sind, löscht es ganz. Die aktuell installierten Versionen bleiben. Den Download-Cache findest du mit brew --cache, standardmäßig ~/Library/Caches/Homebrew. Homebrew löscht direkt, nicht in den Papierkorb. Nach brew install und brew upgrade räumt Homebrew ohnehin die betroffenen Pakete auf und alle 30 Tage alle.

Wie räume ich Docker auf?

Docker Desktop speichert alle Images (Vorlagen, aus denen Container entstehen), Container (laufende oder gestoppte Instanzen davon) und Volumes (Speicher für deren Daten) in einer einzigen großen Datei, Docker.raw. Aufräumen geht deshalb nur über Docker selbst, nie im Finder. docker system df zeigt, wie viel Platz Images, Container, Volumes und Build-Cache belegen. docker system prune entfernt gestoppte Container, Netzwerke, die kein Container nutzt, Images ohne Namen (englisch "dangling images") und ungenutzten Build-Cache und fragt vorher nach. Vorsicht mit den Zusätzen: -a entfernt auch alle übrigen Images, die kein Container nutzt, und --volumes löscht zusätzlich anonyme Volumes, in denen etwa die Daten einer Datenbank liegen können. Was Docker löscht, ist endgültig.

Was solltest du nicht tun?

  • Keine Caches leeren, während eine Installation oder ein Build läuft.
  • node_modules nicht löschen, kurz bevor du ohne Internet arbeiten musst: Die Wiederherstellung lädt fehlende Pakete aus dem Netz.
  • Docker-Volumes nur entfernen, wenn du weißt, was darin liegt, und Docker.raw nie im Finder löschen oder verschieben.

Häufige Fragen

Kann ich node_modules einfach löschen?

Ja, der Ordner enthält nur heruntergeladene Pakete. npm install oder bei vorhandener package-lock.json npm ci im Projektordner stellt ihn wieder her, solange package.json und Lock-Datei erhalten bleiben.

Ist es sicher, den npm-Cache zu löschen?

Ja. Laut npm ist der Cache nur ein Zwischenspeicher, der sich bei Fehlern selbst repariert; geleert werden muss er nur, um Platz zu schaffen. Fehlende Pakete lädt npm bei der nächsten Installation neu.

Löscht brew cleanup meine installierten Programme?

Nein. Es entfernt alte Versionen installierter Formeln, veraltete Downloads und Sperrdateien; die aktuellen Versionen bleiben installiert. Was es löschen würde, zeigt vorher brew cleanup --dry-run.

Warum ist Docker.raw so riesig?

Viele Programme zeigen bei dieser Datei die Höchstgröße, nicht den belegten Platz, wie Docker in seiner Dokumentation erklärt. Den tatsächlich belegten Platz zeigt ls -klsh in der ersten Spalte; frei wird er durch docker system prune, nicht durch Löschen der Datei.

Schneller mit SpaceBroom

SpaceBroom findet im Systemmüll die node_modules von Projekten mit package.json, in denen seit über 90 Tagen keine Datei außerhalb von node_modules und versteckten Ordnern geändert wurde, und wählt sie nicht vor. Daneben zeigt der Systemmüll die Caches von npm, Yarn, pnpm, pip, Go, Cargo, Gradle, CocoaPods, Swift Package Manager und den JetBrains-IDEs mit Pfad und Größe und legt sie in den Papierkorb; pnpm, Gradle und JetBrains wählt er nicht vor. Für Homebrew und Docker bietet er im Bereich Wartung brew cleanup und docker system prune an, nie mit -a oder --volumes: Auf Wunsch misst er vorher, was frei würde, zeigt den Befehl im Bestätigungsdialog und führt ihn erst nach deiner Bestätigung aus; diese Befehle löschen endgültig. Xcode und Simulatoren behandelt der Ratgeber DerivedData, Archive und Simulatoren auf dem Mac aufräumen.

Weitere Ratgeber