Overal node_modules: zo vind je ze, ruim je ze op en krijg je ze terug

Een node_modules-map bevat de afhankelijkheden die voor één JavaScript- of TypeScript-project zijn geïnstalleerd, en is doorgaans een paar honderd megabyte groot. Met tientallen oude projecten loopt dat makkelijk op tot tientallen gigabytes. Je kunt ze veilig verwijderen zolang je package.json en de lockfile bewaart: je pakketbeheerder installeert dezelfde versies opnieuw zodra je naar het project terugkeert.

Vind elke node_modules-map en de grootte ervan

Deze opdracht doorzoekt je thuismap, slaat ~/Library en de prullenmand over en toont elke node_modules-map met de grootte, met de grootste onderaan:

find ~ \( -path "$HOME/Library" -o -path "$HOME/.Trash" \) -prune -o -type d -name node_modules -prune -print0 2>/dev/null | xargs -0 du -sh 2>/dev/null | sort -h

Zo werkt het: de eerste -prune slaat de twee uitgesloten mappen over, -type d -name node_modules vindt de mappen, en de tweede -prune zorgt dat find er niet in afdaalt, zodat geneste node_modules één keer worden meegeteld, binnen hun bovenliggende map. du -sh meet elke map en sort -h sorteert de lijst. De opdracht leest alleen. Bij een grote thuismap kan het een paar minuten duren, en Terminal kan om toegang vragen tot Documenten, Bureaublad of Downloads.

Negeer resultaten in mappen van tools zoals ~/.nvm, ~/.vscode of ~/.cursor. Die horen bij geïnstalleerde tools en editorextensies, niet bij je projecten.

Gebruiken je projecten pnpm, dan zijn de getoonde groottes groter dan wat je terugkrijgt. Verderop lees je waarom.

Verwijder de mappen die je niet nodig hebt

Open voordat je iets verwijdert de projectmap en controleer of er een lockfile in staat: package-lock.json (npm), pnpm-lock.yaml (pnpm), yarn.lock (Yarn) of bun.lock / bun.lockb (Bun). Bewaar die, en bewaar ook package.json.

De veiligste manier om te verwijderen is node_modules in de Finder naar de prullenmand te slepen. Zolang je de prullenmand niet leegt, kun je nog van gedachten veranderen. Met veel kleine bestanden duurt het verplaatsen naar de prullenmand even.

Vanuit Terminal, in één projectmap:

cd ~/Projects/old-app
rm -rf node_modules

rm -rf verwijdert definitief, zonder prullenmand. Controleer eerst met pwd in welke map je staat, en gebruik het nooit met een jokerteken of een lege variabele.

npkill: een interactief alternatief

npkill toont node_modules-mappen met hun grootte en laat je ze met één toetsaanslag tegelijk verwijderen:

npx npkill -d ~/Projects

-d bepaalt waar de zoektocht begint; zonder die optie begint npkill in de huidige map. Navigeer met de pijltoetsen en druk op de spatiebalk of Del om de geselecteerde map te verwijderen. npkill verwijdert meteen, zonder prullenmand. Mappen die apps nodig hebben om te werken, markeert het met ⚠️; laat die met rust. Met --dry-run simuleer je het verwijderen als je het eerst wilt uitproberen.

Opnieuw installeren als je terugkeert naar een project

Gebruik de opdracht die precies installeert wat in de lockfile staat:

npm ci vereist een lockfile, verwijdert eerst een eventuele bestaande node_modules en wijzigt nooit package.json of de lockfile. Een gewone npm install werkt ook, maar kan de lockfile bijwerken.

Andere mappen die zichzelf opnieuw opbouwen

Frameworks en buildtools bewaren caches en uitvoer naast node_modules. In projecten die je niet draait, kun je ze veilig verwijderen; de volgende build of devserver maakt ze opnieuw aan.

dist en build bevatten meestal ook builduitvoer, maar de namen zijn algemeen. Sommige projecten committen daar bestanden of gebruiken ze voor iets anders, dus kijk erin voordat je ze verwijdert.

Zo toon je de frameworkcaches in een projectenmap:

find ~/Projects -type d \( -name .next -o -name .nuxt -o -name .svelte-kit -o -name .turbo -o -name .parcel-cache \) -prune -print0 | xargs -0 du -sh | sort -h

De globale pakketcaches wissen

Elke pakketbeheerder houdt daarnaast een downloadcache bij die alle projecten delen. Die wissen is definitief, maar onschuldig: pakketten worden opnieuw gedownload als dat nodig is.

npm cache clean --force
pnpm store prune
yarn cache clean
bun pm cache rm

• npm bewaart zijn cache in ~/.npm/_cacache. De documentatie van npm cache legt uit waarom clean --force nodig heeft en vermeldt dat npm cache verify opruimt zonder alles te legen. Pakketten die npx ophaalt, staan in ~/.npm/_npx.
• pnpm bewaart zijn opslag op macOS in ~/Library/pnpm/store (pnpm store path toont die van jou). pnpm store prune verwijdert alleen pakketten waarnaar geen project verwijst, en de documentatie van pnpm raadt aan het af en toe uit te voeren, niet voortdurend.
• Yarn Classic cachet in ~/Library/Caches/Yarn. Bij Yarn Berry leegt yarn cache clean --mirror de globale cache in ~/.yarn/berry/cache.
• Bun cachet in ~/.bun/install/cache; bun pm cache rm maakt die leeg.

Ook oude Node.js-versies die je met nvm hebt geïnstalleerd, tellen op in ~/.nvm/versions/node; met nvm uninstall <version> verwijder je een versie die je niet meer nodig hebt.

Waarom pnpm minder vrijmaakt dan du aangeeft

npm en Yarn Classic kopiëren elk pakket naar de node_modules van elk project. pnpm bewaart elk pakket één keer, in een content-addressable store, en linkt de bestanden in elk project dat het pakket gebruikt. Op macOS probeert de standaardinstelling packageImportMethod van pnpm eerst APFS-klonen en daarna harde links.

Hoe dan ook worden de bytes gedeeld. du telt in elk project toch de volledige grootte, dus de node_modules van een pnpm-project verwijderen levert meestal veel minder op dan werd aangegeven. De ruimte komt terug wanneer pnpm store prune pakketten verwijdert die geen overgebleven project meer gebruikt. Daarvoor moet de opslag op dezelfde schijf staan als het project; projecten op een externe schijf krijgen daar een eigen opslag.

Hoe MoreRoom helpt

De gratis versie van MoreRoom vindt node_modules-mappen in projecten die een lockfile hebben en 30 dagen niet zijn aangeraakt, plus frameworkcaches zoals .next en .turbo, en labelt ze als “Veilig te verwijderen”. Het slaat ~/Library over, net als mappen van tools zoals ~/.nvm en ~/.vscode. Je verplaatst onderdelen één voor één naar de prullenmand, met Herstel. Voor de npm-cache en de pnpm-opslag voert MoreRoom npm cache clean --force en pnpm store prune uit; die opdrachten zijn definitief en worden ook zo gelabeld.

MoreRoom Pro voegt Projectwinterslaap toe: inactieve projecten laten mappen vallen die opnieuw kunnen worden opgebouwd, zoals node_modules en builduitvoer, en worden met één klik weer wakker zodra je terugkeert. Pro bevat ook de Verzamelaar en Doelmodus.