De npm-cache op je Mac veilig wissen

Scheid de npm-cache van afhankelijkheden en projectbestanden

De npm-cache bewaart herbruikbare downloads voor meerdere projecten en staat op macOS standaard onder ~/.npm, maar kan anders zijn ingesteld. node_modules is daarentegen de boom van geïnstalleerde afhankelijkheden van één project. package.json en package-lock.json zijn projectgegevens, geen cache. npm-shrinkwrap.json is evenmin cache: npm v12 leest het bestand niet meer. Hernoem het alleen naar package-lock.json als het de enige lockfile is en package-lock.json nog niet bestaat; overschrijf nooit een bestaande lockfile tijdens cacheonderhoud.

Meet de actieve cache en controleer hem eerst

Ga er niet van uit dat een bestaande ~/.npm ook de actieve cache is. npm config get cache geeft het pad voor de huidige configuratie; meet precies dat pad met du en noteer de vrije opslagruimte. npm cache verify controleert de index en cachegegevens, verifieert de integriteit en verwijdert gegevens die niet meer nodig zijn, terwijl geldige downloads bewaard blijven. Voor normaal onderhoud of een installatiefout buiten de cache is dat vaak genoeg.

1. Voer npm --version en npm config get cache uit en bevestig dat het getoonde pad een cachelocatie is, geen projectmap.
2. Meet precies dat pad met du -sh en noteer de vrije macOS-opslag; laat package.json en lockfiles ongewijzigd.
3. Stop actieve npm install-, npm ci-, npm exec- en publicatieprocessen, voer npm cache verify uit en bewaar de samenvatting en eventuele fout.
4. Voer npm cache clean --force alleen uit als verify niet volstaat, de ruimtewinst relevant is en alle benodigde artefacten later weer bereikbaar zijn.
5. Voer npm cache verify opnieuw uit, meet hetzelfde pad en draai voor een representatief project de normale installatie, build en tests met de ongewijzigde lockfile.

Geef nooit een ongecontroleerd pad door aan rm -rf. Combineer het wissen van de cache ook niet met het verwijderen of opnieuw maken van een lockfile: dan verander je twee oorzaken tegelijk en verlies je de vergelijkingsbasis.

Gebruik npm cache clean --force alleen bewust

Voer npm cache clean --force alleen uit als de gemeten cache groot genoeg is, de ruimte nu nodig is en je later opnieuw kunt downloaden. Het commando wist de ingestelde cache, niet node_modules of lockfiles. Daarna kunnen installaties en npm ci trager zijn of offline mislukken; privépakketregisters, Git-hosts, proxy’s en niet meer aangeboden pakketten verhogen de herstelkosten. Stel force niet blijvend in de npm-configuratie in.

Controleer het resultaat zonder de afhankelijkheden te wijzigen

Vraag na het wissen het cachepad opnieuw op, meet dezelfde locatie en vergelijk de daadwerkelijk beschikbare opslagruimte in macOS. Voer voor één representatief project de normale installatie- of buildopdracht uit met ongewijzigde package.json en lockfile, en draai daarna de tests. Komt de oorspronkelijke fout terug, wis de cache dan niet nogmaals: ERESOLVE, ontbrekende aanmelding, 404, proxy- of certificaatproblemen, Node.js-engines, native builds en lifecycle-scripts vragen om een eigen diagnose. AskClean herkent standaard ~/.npm; controleer aangepaste paden met npm zelf.

Grenzen voor verwijderen en herstelkosten

Vind en meet de actieve npm-downloadcache, controleer hem eerst en wis hem alleen met een goede reden, zonder node_modules of projectbestanden aan te raken.

FAQ