Juli 2026 · Mac-Leitfaden für Entwickler

node_modules auf dem Mac in allen Projekten löschen

Jedes Projekt, das Sie je gestartet haben, behält seine eigene Kopie von node_modules, und zusammen sind das Dutzende Gigabyte, die Sie längst vergessen haben. So finden Sie jeden Ordner, sehen seine Größe, räumen alle sicher weg und installieren neu, sobald Sie zurückkommen.

Von Ram Velmurugan · Founder & Lead Developer, 1dot.ai

Terminal und grafische Oberfläche·Sicher und umkehrbar·9 Min. Lesezeit
Kurz gesagt

Listen Sie im Projektordner jeden node_modules-Ordner mit seiner Größe auf: find . -type d -name node_modules -prune -exec du -sh {} + | sort -hr. Löschen Sie dann alle mit find . -type d -name node_modules -prune -exec rm -rf {} +. Lieber mit Sichtprüfung? Dann führen Sie npx npkill aus und löschen die Ordner einzeln.

Das ist sicher, weil node_modules erzeugt und nicht von Hand geschrieben wird. Solange das Projekt seine package.json und sein Lockfile behält, baut npm install den Ordner genau so wieder auf, wie er war.

Öffnen Sie „Über diesen Mac“, klicken Sie auf Speicher, und da liegt ein riesiger Block Systemdaten oder Entwickler-Dateien, in den man nicht hineinklicken kann. Wenn Sie JavaScript schreiben, ist ein großer Teil davon mit ziemlicher Sicherheit node_modules: der Abhängigkeitsordner, den npm, Yarn und pnpm in jedem Projekt anlegen, für das Sie je eine Installation ausgeführt haben.

Das Problem ist keiner dieser Ordner für sich. Eine React- oder Next.js-App bringt 200 bis 500 MB in node_modules mit, und das wirkt vernünftig, solange Sie daran arbeiten. Das Problem ist, dass zwanzig solcher Ordner verstreut liegen: in alten Nebenprojekten, in Kundenarbeit, die Sie letztes Jahr abgeschlossen haben, und in Tutorials, die Sie einmal geklont und nie wieder geöffnet haben. Jeder davon hält weiter seine vollständige Kopie auf der Platte. Niemand löscht sie, weil sich niemand an sie erinnert.

Dieser Leitfaden zeigt, wie Sie alle auf einmal sichtbar machen, genau sehen, wie viel Platz jeder belegt, und die überflüssigen entfernen, ohne eine einzige Zeile Ihres eigentlichen Codes anzufassen.

Warum node_modules still und leise Ihre Platte füllt

In node_modules installiert Ihr Paketmanager jede Bibliothek, von der Ihr Projekt abhängt, dazu jede Bibliothek, von der diese abhängen, bis ganz nach unten. Ein modernes Frontend-Projekt zieht so Hunderte Pakete herein, und der Baum wird als Zehntausende winziger Dateien gespeichert. Drei Dinge sorgen dafür, dass sich das schneller anhäuft als erwartet.

  • Zwischen Projekten wird nichts geteilt. Bei npm und dem klassischen Yarn bekommt jedes Projekt eine vollständige eigene Kopie jeder Abhängigkeit. Zehn Projekte mit React speichern React zehnmal.
  • Im Finder ist es normalerweise unsichtbar. node_modules ist nichts, worin man stöbert, also taucht es nie auf, wenn Sie nach Platz suchen. macOS zählt das meiste davon zu den Systemdaten, in die Sie nicht hineinklicken können.
  • Alte Projekte werden nie aufgeräumt. Sie schließen ein Projekt ab, machen weiter, und sein node_modules bleibt genau so schwer wie an dem Tag, an dem Sie zuletzt npm install ausgeführt haben. Ein Ablaufdatum gibt es nicht.

Zusammengerechnet trägt ein Entwickler-Mac im Alltag regelmäßig 5 bis 30 GB an node_modules-Ordnern mit sich herum, manchmal weit mehr. Die gute Nachricht: Fast nichts davon lohnt das Aufheben, denn jedes Byte lässt sich bei Bedarf neu erzeugen.

Warum das Löschen sicher (und umkehrbar) ist

Diese eine Idee macht das ganze Aufräumen risikoarm: node_modules wird erzeugt, nicht geschrieben. Sie schreiben nie Code darin. Der Ordner entsteht vollständig aus zwei Dateien, die in Ihrem Projekt liegen und in Git eingecheckt sind:

  • package.json listet die Abhängigkeiten auf, die Ihr Projekt anfordert.
  • Das Lockfile (package-lock.json für npm, yarn.lock für Yarn oder pnpm-lock.yaml für pnpm) hält die genauen Versionen fest, die installiert wurden.

Führen Sie npm install, yarn oder pnpm install aus, dann liest der Paketmanager diese beiden Dateien und baut node_modules in exakt denselben Zustand zurück. Deshalb steht node_modules auch in fast jedem Projekt in der .gitignore: Der Ordner ist von vornherein zum Wegwerfen gedacht und wird nie ins Repository eingecheckt. Ihn zu löschen ändert weder Ihr Repo noch Ihre Historie noch Ihren Quellcode.

Das Einzige, was Sie prüfen sollten
Ein Projekt lässt sich nur dann gefahrlos leeren, wenn es ein Lockfile hat. Finden Sie einen alten Ordner mit package.json, aber ohne Lockfile, führen Sie einmal npm install aus und checken das erzeugte Lockfile ein, bevor Sie aufräumen. So können Sie später sicher dieselben Versionen wiederherstellen.

Alle node_modules samt Größe finden

Löschen Sie nie, bevor Sie nachgesehen haben. Der erste Befehl findet jeden node_modules-Ordner unterhalb eines Ordners und gibt seine Größe aus, den größten zuerst, damit Sie sehen, womit Sie es zu tun haben. Richten Sie ihn auf den Ort, an dem Ihr Code liegt. Viele Entwickler nutzen ~/Developer, bei Ihnen kann es aber auch ~/Projects, ~/code oder eine Handvoll verschiedener Orte sein.

find ~/Developer -type d -name node_modules -prune -exec du -sh {} + | sort -hr

Das macht jeder Teil:

  • -type d -name node_modules trifft Ordner mit dem Namen node_modules.
  • -prune sorgt dafür, dass find nicht in einen node_modules-Ordner hinabsteigt, sobald es einen gefunden hat. Das ist wichtig, weil Abhängigkeiten ihre eigenen verschachtelten node_modules haben. Ohne prune würden Sie diese doppelt zählen und Zeit damit verschwenden, Millionen von Dateien abzulaufen.
  • -exec du -sh {} + gibt für jeden Treffer eine gut lesbare Größe aus.
  • sort -hr setzt die größten Ordner nach oben.

Die Ausgabe sieht etwa so aus, und die schlimmsten Platzfresser springen sofort ins Auge:

482M  /Users/you/Developer/old-client-dashboard/node_modules
417M  /Users/you/Developer/nextjs-experiment/node_modules
361M  /Users/you/Developer/react-native-app/node_modules
298M  /Users/you/Developer/gatsby-blog-2023/node_modules
 96M  /Users/you/Developer/cli-tool/node_modules

Um die Gesamtsumme über alles zu sehen, addieren Sie die Größen in einem zweiten Durchgang. Dieser gibt eine einzige Gesamtzahl aus, damit Sie wissen, um wie viel es geht:

find ~/Developer -type d -name node_modules -prune -exec du -sk {} + | awk '{sum += $1} END {printf "%.1f GB total\n", sum/1024/1024}'

Jetzt haben Sie eine echte Zahl und eine Liste. Machen alte Nebenprojekte und abgeschlossene Kundenarbeit den Großteil aus, holen Sie den meisten Platz zurück, ohne irgendetwas anzufassen, an dem Sie gerade arbeiten.

Löschen in einer Zeile, und warum -prune wichtig ist

Wenn Sie die Liste geprüft haben und sich sicher sind, ist das Löschen derselbe Befehl mit rm -rf anstelle von du. Führen Sie ihn innerhalb Ihres Projektordners aus oder geben Sie den Ordner ausdrücklich an:

# innerhalb Ihres Projektordners
find . -type d -name node_modules -prune -exec rm -rf {} +

Die Option -prune leistet hier echte Arbeit und spart nicht nur Zeit. Wenn find einen node_modules-Ordner auf oberster Ebene trifft und ihn abschneidet, wird er als Ganzes entfernt, ohne vorher in die verschachtelten node_modules jeder Abhängigkeit hinabzusteigen. Das hält den Vorgang schnell und verhindert, dass find in Verzeichnisse absteigen will, die rm -rf ihm gerade unter den Füßen wegzieht.

Bevor Sie rm -rf ausführen
rm -rf nutzt nicht den Papierkorb und lässt sich nicht rückgängig machen. Führen Sie zuerst die du-Variante des Befehls aus und lesen Sie die Liste. Achten Sie darauf, dass Sie sich in Ihrem Projektordner befinden und nicht in Ihrem Benutzerordner oder im Wurzelverzeichnis der Festplatte, damit die Suche nie in App-Bundles oder Library-Caches gerät. Im Zweifel nehmen Sie npkill, das Ihnen jeden Ordner vor dem Löschen zeigt.

Wollen Sie nur die Abhängigkeiten eines einzelnen Projekts löschen, brauchen Sie find gar nicht. Wechseln Sie in das Projekt und führen Sie rm -rf node_modules aus. Installieren Sie mit Ihrem Paketmanager neu, wenn Sie wieder daran arbeiten.

npkill: der interaktive Weg

Wenn Ihnen ein blindes Alles-löschen nicht geheuer ist, ist npkill die freundlichere Wahl. Das kostenlose Kommandozeilenwerkzeug sucht nach node_modules-Ordnern und lässt Sie diese einzeln aus einer laufend aktualisierten, sortierbaren Liste löschen. Dauerhaft installieren müssen Sie nichts. Starten Sie es mit npx:

npx npkill

Es sucht ab dem Ordner, in dem Sie es starten, zeigt jeden gefundenen node_modules-Ordner mit Größe und letztem Änderungsdatum und lässt Sie mit den Pfeiltasten durch die Liste gehen. Drücken Sie bei einem Ordner die Entfernen-Taste, um ihn zu löschen. Sie sehen jeden verschwinden und den Platz in Echtzeit zurückkommen.

Der Grund, es einem rohen Befehl vorzuziehen, ist Sicherheit. Manche installierten Apps, darunter Spotify und Discord, bringen ihr eigenes node_modules mit und brauchen es tatsächlich zum Laufen. npkill markiert solche Ordner mit einer Warnung, damit Sie nichts löschen, was eine App kaputt macht. Ein schlichter rm -rf-Durchlauf von zu weit oben würde sie kommentarlos entfernen.

Tipp
Sortieren Sie die Liste in npkill nach Größe und fangen Sie oben an. Eine Handvoll der größten Ordner macht meist den Großteil des Platzes aus, sodass Sie in ein paar Minuten Dutzende Gigabyte zurückholen, ohne jeden Eintrag durchzuscrollen.

Welche Methode passt

Alle drei Ansätze entfernen dieselben Ordner. Sie unterscheiden sich darin, wie viel Kontrolle Sie haben und wie sehr Sie sich selbst ein Löschen mit Platzhaltern zutrauen.

MethodeAm besten fürKontrolleTempo
find + du (messen)Das ganze Bild sehen, bevor Sie handelnNur lesendSchnell
find + rm -rfAlles unter einem Ordner in einem Durchgang leerenAlles oder nichtsAm schnellsten
npkillOrdner für Ordner prüfen und löschenPro Ordner, mit WarnungenSchnell
rm -rf node_modulesEin einzelnes Projekt aufräumenEin ProjektSofort
System Cleaner (App)Auch Caches außerhalb von Node, in einem PrüfdurchgangPro Eintrag, mit PrüfungSchnell

Ein guter Standard: Führen Sie den find + du-Befehl aus, um die Liste zu sehen, und löschen Sie die großen Ordner dann mit npkill, jeden mit eigenem Blick darauf. Greifen Sie zum find + rm -rf-Einzeiler nur, wenn Sie sicher sind, dass der ganze Ordner geleert werden darf, etwa ein Archivverzeichnis mit abgeschlossenen Projekten.

Alle node_modules auf Ihrem Mac finden

System Cleaner listet node_modules in einem Durchgang neben Xcode-Caches, Flutter-Build-Ordnern und Gradle-Caches auf und löscht nur die Ordner, die Sie anhaken. Der Cleaner ist vollständig kostenlos.

macOS 12 or later. 25 free AI renames, no account needed.

Worauf Sie achten sollten

Beim Aufräumen von node_modules kann genau zweierlei schiefgehen, und beides lässt sich leicht vermeiden.

  • Das Löschen von zu weit oben starten. Führen Sie den find-Befehl in Ihrem Benutzerordner oder im Wurzelverzeichnis der Festplatte aus, kann er in App-Bundles und Library-Ordner greifen, die ihr eigenes node_modules enthalten. Bleiben Sie in Ihrem Projektverzeichnis, oder lassen Sie npkill die Ordner von Apps für Sie markieren.
  • Ein Projekt ohne Lockfile leeren. Ohne eingechecktes Lockfile kann eine Neuinstallation neuere, leicht abweichende Versionen Ihrer Abhängigkeiten holen. Bei einem aktiven Projekt ist das relevant. Erzeugen Sie zuerst ein Lockfile, checken Sie es ein und räumen Sie dann auf.

Alles andere ist unbedenklich. Quellcode können Sie so nicht verlieren, denn Ihr Code liegt nie in node_modules. Das Schlimmste, was ein Fehler realistisch kostet, ist eine Neuinstallation mit einer Zeile.

Ein Projekt zurückholen

Kehren Sie zu einem Projekt zurück, dessen node_modules Sie geleert haben, genügt zum Wiederherstellen ein einziger Befehl im Projektordner. Nehmen Sie den Paketmanager, den das Projekt nutzt. Welcher das ist, verrät das Lockfile:

npm install     # package-lock.json
yarn            # yarn.lock
pnpm install    # pnpm-lock.yaml

Der Paketmanager liest das Lockfile und installiert genau die Versionen, die Sie vorher hatten. Bei einem typischen Projekt dauert das Sekunden bis wenige Minuten, je nach Verbindung und je nachdem, ob die Pakete noch im lokalen Cache des Paketmanagers liegen. Das ist der ganze Handel: ein wenig Installationszeit gegen Gigabyte an freiem Speicher für Projekte, die Sie heute nicht anfassen.

Damit es nicht wieder vollläuft

node_modules einmal zu leeren fühlt sich gut an, aber der Ordner wächst bei der nächsten Installation nach. Ein paar Gewohnheiten sorgen dafür, dass er nie wieder Dutzende Gigabyte erreicht.

  • Auf pnpm umsteigen. pnpm speichert jede Paketversion nur einmal in einem globalen, inhaltsadressierten Speicher und verlinkt sie per Hardlink in jedes Projekt. Zehn Projekte mit derselben React-Version teilen sich eine einzige Kopie auf der Platte, statt zehn zu behalten. Wer mehrere Projekte jongliert, bekommt damit die wirksamste strukturelle Lösung.
  • Abgeschlossene Arbeit gleich aufräumen. Sobald Sie ein Kundenprojekt abschließen oder ein Nebenprojekt auf Eis legen, löschen Sie sein node_modules. Das Lockfile bleibt in Git, es geht also nichts verloren, und der Ordner entsteht neu, falls Sie das Projekt je wieder öffnen.
  • Alle paar Monate die Größe prüfen. Führen Sie den find + du-Befehl regelmäßig aus. Bei 8 GB ist das Aufräumen eine Sache von zwei Minuten. Bei 40 GB ist es Panik, wenn die Platte mitten im Build vollläuft.
  • Auch den Cache des Paketmanagers leeren. Der globale Download-Cache wächst unabhängig von node_modules. npm cache clean --force, yarn cache clean und pnpm store prune holen diesen Platz zurück, wenn er groß wird.

node_modules ist selten das Einzige, was einen Entwickler-Mac aufbläht. Xcode DerivedData, iOS-Simulatoren, Docker-Images und alte Build-Ausgaben sammeln sich parallel an. Ist die Platte nach dem Leeren von node_modules noch knapp, sind das die nächsten Stellen. Unser Leitfaden zum Thema Xcode-Cache aufräumen behandelt den größten davon.

Wann sich ein Aufräumwerkzeug lohnt

Die Befehle oben sind das richtige Werkzeug, wenn Sie im Terminal zu Hause sind und sich nur um node_modules kümmern. Eine eigene App hilft dann, wenn Sie lieber alle Entwickler-Caches Ihres Mac auf einen Blick sehen möchten und wenn node_modules nur ein Teil des Problems ist.

Files Magic AI enthält einen System Cleaner mit einer Ansicht für Developer Caches. Sie zeigt node_modules-Ordner, Xcode DerivedData und andere Build-Caches auf dem ganzen Mac in einer einzigen Liste, nennt ihre Größe und löscht sie nach einer Prüfung, sodass nichts ohne Ihre Zustimmung verschwindet. Er steht neben der KI-Dateiorganisation auf dem Gerät und Magic Rename, das standardmäßig auf dem Gerät arbeitet, um die herum die App gebaut ist. Platz zurückzuholen ist damit ein Teil davon, den Rechner in Ordnung zu halten, und kein eigener Botengang mit eigenem Werkzeug.

Das ersetzt weder find noch npkill. Wenn Sie die Kommandozeile mögen, bleiben Sie dabei. Die App ist für Entwickler gedacht, die lieber auf eine Liste schauen, die überflüssigen Ordner anhaken und im selben Durchgang auch die Caches außerhalb von Node erwischen wollen.


Häufige Fragen

Kann ich node_modules gefahrlos löschen?
Ja, solange das Projekt noch seine package.json und ein Lockfile hat. node_modules ist ein Build-Ordner voller heruntergeladener Abhängigkeiten, nicht Ihr Quellcode. Führen Sie npm install, yarn oder pnpm install aus, und er kommt genau so zurück, wie er war. Innehalten sollten Sie nur bei einem Projekt ohne Lockfile: Installieren Sie dort neu und checken Sie ein Lockfile ein, bevor Sie aufräumen.
Wie finde ich alle node_modules-Ordner auf meinem Mac?
Richten Sie find auf Ihren Projektordner und lassen Sie jeden Treffer mit Größe auflisten: find ~/Developer -type d -name node_modules -prune -exec du -sh {} + | sort -hr. Die Option -prune verhindert, dass find in verschachtelte node_modules hinabsteigt. Das geht schnell und zählt nichts doppelt. Ersetzen Sie ~/Developer durch den Ort, an dem Ihr Code liegt.
Wie lösche ich alle node_modules-Ordner auf einmal?
Führen Sie in Ihrem Projektordner find . -type d -name node_modules -prune -exec rm -rf {} + aus. Der Befehl findet jeden node_modules-Ordner, überspringt die darin verschachtelten und löscht alle in einem Durchgang. Führen Sie denselben Befehl vorher immer mit du aus, damit Sie genau sehen, was entfernt wird.
Was ist npkill und wie funktioniert es?
npkill ist ein kostenloses Kommandozeilenwerkzeug, das Sie mit npx npkill starten. Es sucht ab dem aktuellen Ordner, listet jeden node_modules-Ordner nach Größe sortiert auf und lässt Sie jeden davon mit den Pfeiltasten und der Entfernen-Taste löschen. Ordner, die zu installierten Apps wie Spotify oder Discord gehören, markiert es mit einer Warnung. Das macht es sicherer als ein blinder Befehl, der alles löscht.
Warum ist node_modules so groß?
Paketmanager legen den gesamten Abhängigkeitsbaum flach auf der Platte ab, sodass eine einzige React- oder Next.js-App oft 200 bis 500 MB in Zehntausenden kleiner Dateien belegt. Bei npm und dem klassischen Yarn wird zwischen Projekten nichts geteilt, jedes behält also seine vollständige eigene Kopie. Zehn bis zwanzig Projekte kommen so auf 5 bis 30 GB, das meiste davon unter Systemdaten verbucht, wo Sie es nie sehen.
Sollte ich node_modules in die .gitignore aufnehmen?
Ja, und fast jedes Projekt tut das bereits. node_modules wird aus der package.json und dem Lockfile erzeugt und sollte daher nie eingecheckt werden. Weil Git den Ordner ignoriert, berührt sein Löschen Ihr Repository überhaupt nicht: Er entsteht bei der nächsten Installation aus Ihrem eingecheckten Manifest neu, und genau deshalb ist das Leeren sicher.
Wie verhindere ich, dass node_modules meine Platte wieder füllt?
Steigen Sie auf pnpm um. Es speichert jedes Paket einmal in einem globalen Speicher und verlinkt es per Hardlink in jedes Projekt, sodass zehn Kopien einer Abhängigkeit nur den Platz von einer belegen. Löschen Sie node_modules in Projekten, die Sie seit Monaten nicht geöffnet haben, denn bei Ihrer Rückkehr sind sie in Sekunden neu installiert. Und prüfen Sie alle paar Monate kurz mit find die Größen, damit sich nie wieder etwas aufstaut.

Sie möchten den Mac-Speicher auch über node_modules hinaus im Griff haben? Unser Leitfaden Speicherplatz auf dem Mac freigeben behandelt Duplikate, DMGs und weitere Entwickler-Caches, der Leitfaden zum Xcode-Cache nimmt sich den anderen großen Brocken auf einem Entwicklerrechner vor, und unser Vergleich der besten Mac-Reinigungs-Apps bewertet die Werkzeuge, die das automatisieren.

Veröffentlicht am 14. Juli 2026 · Weitere Leitfäden · Files Magic AI

Eine Liste statt eines find-Befehls

npkill und find erledigen beide die Aufgabe. Wenn Sie die Reste von Gradle, Flutter und Xcode im selben Durchgang erwischen wollen, zeigt der Cleaner von Files Magic AI alles zusammen an, mit einer Prüfung vorab.

macOS 12 or later. 25 free AI renames, no account needed.