node_modules op je Mac verwijderen zonder je project kwijt te raken

Maak onderscheid tussen node_modules en de rest van je project

node_modules bevat de geïnstalleerde afhankelijkheden van één project en is onder de juiste voorwaarden opnieuw op te bouwen. Na verwijdering kan het project niet draaien of bouwen tot de installatie klaar is. package.json, lockfiles, broncode, configuratie, patches, workspacebestanden en Git-geschiedenis zijn de bouwinstructies en mogen niet weg. De gedeelde npm-downloadcache onder ~/.npm is een aparte opslagcategorie.

Controleer of je de afhankelijkheden echt opnieuw kunt installeren

Een lockfile maakt een herinstallatie voorspelbaarder, maar is geen back-up van pakketten. Controleer de door het project gebruikte pakketbeheerder en versie, toegang tot privépakketregisters, VPN, Git- en file:-afhankelijkheden, lokale workspaces, externe downloads en native toolchains. npm v12 leest npm-shrinkwrap.json niet meer. Staat alleen dat bestand in de projectroot en bestaat package-lock.json nog niet, hernoem het dan naar package-lock.json; beide bestanden hebben dezelfde indeling. Overschrijf nooit een bestaande package-lock.json. Wijzigingen die alleen in node_modules staan, verdwijnen bij verwijdering.

1. Voer in de projectroot pwd en du -sh ./node_modules uit en noteer ook de vrije macOS-opslag.
2. Controleer package.json, de juiste lockfile, het packageManager-veld, workspaceconfiguratie en git status, en maak een back-up van lokale bron- en configuratiewijzigingen. Hernoem npm-shrinkwrap.json voor npm v12 alleen als dit de enige lockfile is en package-lock.json nog niet bestaat.
3. Bevestig toegang tot privépakketregisters, Git- en file:-afhankelijkheden, lokale pakketten, externe downloads en buildtools, en stop alle processen die node_modules gebruiken.
4. Verplaats alleen de gecontroleerde node_modules-map naar de Prullenmand en installeer vanaf de juiste repositoryroot opnieuw met de vastgelegde pakketbeheerder en de lockfile.
5. Voer de build, tests, lintcontrole en de startprocedure van de app uit, meet de opslag opnieuw en leeg pas daarna de Prullenmand.

Gebruik node_modules nooit als enige kopie van een pakket of handmatige aanpassing. Als de exacte afhankelijkheid niet meer beschikbaar en nergens gearchiveerd is, kan verwijderen een oud project onbruikbaar maken.

Verwijder precies één gecontroleerde map met afhankelijkheden

Verplaats in het gecontroleerde project alleen node_modules naar de Prullenmand in Finder, nooit de bovenliggende projectmap. rm -rf ./node_modules omzeilt de Prullenmand en is onomkeerbaar; controleer daarom eerst de projectroot opnieuw met pwd. Gebruik daar npm ci als package-lock.json leidend is, of de frozen-lockfile-werkwijze van het project voor pnpm, Yarn of Bun. Behandel een monorepo vanuit de repositoryroot met de bijbehorende lockfile als één afhankelijkheidssysteem.

Herinstalleer en controleer het hele project

Een geslaagde installatie bewijst nog niet dat het project is hersteld. Voer de gedocumenteerde build, tests, lintcontrole en startprocedure uit; native add-ons en lifecycle-scripts kunnen na een toolchainwijziging alsnog mislukken. Herstel kost downloads, uitpakken, links aanmaken en soms compileren. Zet bij een fout de map terug uit de Prullenmand en onderzoek toegangsrechten, netwerk, versies en lockfile voordat je nog een project opruimt.

Grenzen voor verwijderen en herstelkosten

Vind grote node_modules-mappen, bescherm broncode en lockfiles, verwijder afhankelijkheden per project en installeer ze veilig opnieuw met npm, pnpm, Yarn of Bun.

FAQ