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
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.
- Warum node_modules still und leise Ihre Platte füllt
- Warum das Löschen sicher (und umkehrbar) ist
- Alle node_modules samt Größe finden
- Löschen in einer Zeile, und warum
-prunewichtig ist - npkill: der interaktive Weg
- Welche Methode passt
- Worauf Sie achten sollten
- Ein Projekt zurückholen
- Damit es nicht wieder vollläuft
- Wann sich ein Aufräumwerkzeug lohnt
- FAQ
Ö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 installausgefü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.jsonlistet die Abhängigkeiten auf, die Ihr Projekt anfordert.- Das Lockfile (
package-lock.jsonfür npm,yarn.lockfür Yarn oderpnpm-lock.yamlfü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.
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 -hrDas macht jeder Teil:
-type d -name node_modulestrifft Ordner mit dem Namen node_modules.-prunesorgt 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 -hrsetzt 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_modulesUm 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.
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 npkillEs 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.
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.
| Methode | Am besten für | Kontrolle | Tempo |
|---|---|---|---|
| find + du (messen) | Das ganze Bild sehen, bevor Sie handeln | Nur lesend | Schnell |
| find + rm -rf | Alles unter einem Ordner in einem Durchgang leeren | Alles oder nichts | Am schnellsten |
| npkill | Ordner für Ordner prüfen und löschen | Pro Ordner, mit Warnungen | Schnell |
| rm -rf node_modules | Ein einzelnes Projekt aufräumen | Ein Projekt | Sofort |
| System Cleaner (App) | Auch Caches außerhalb von Node, in einem Prüfdurchgang | Pro Eintrag, mit Prüfung | Schnell |
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.yamlDer 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 cleanundpnpm store pruneholen 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
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.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.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.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.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.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.