Wojny node_modules: odzyskujemy gigabajty z martwych projektów pobocznych

Dlaczego jeden folder potrafi ważyć więcej niż system

npm instaluje wszystkie zależności w lokalnym node_modules każdego projektu — bez współdzielenia i bez deduplikacji między projektami. Skromna aplikacja webowa z łatwością ciągnie 800 MB–2 GB na tysiącu pakietów, a prawdziwym zabójcą jest liczba plików: dziesiątki tysięcy drobiazgów, które skanuje Windows Defender, po których pełzają narzędzia backupu i na których OneDrive — jeśli projekty żyją w synchronizowanym folderze — krztusi się w nieskończoność. To też powód, dla którego instalacja na Windows trwa minuty, a na Linuksie sekundy: narzut na tworzenie małych plików jest bezlitosny. Po pięciu porzuconych eksperymentach patrzysz na 10–15 GB, których nic aktywnie nie używa.

Kasuj bez strachu: lockfile to twoja gwarancja

Kontrakt jest prosty: package.json mówi, czego potrzebujesz, package-lock.json — jakich dokładnie wersji używałeś, a node_modules to jedynie rozpakowany wynik tych dwóch. Usuń node_modules, odpal npm ci, a po kilku minutach identyczne drzewo wraca — to nie sztuczka ratunkowa, to zamierzony przepływ pracy. Jedyny nieprzebaczalny błąd to usunięcie lockfile'a albo pozwolenie, by projekt gnijł bez lockfile'a wrzuconego do repozytorium. Do szukania folderów: npx npkill skanuje wszystkie dyski, wypisuje każdy node_modules z rozmiarem i datą modyfikacji i kasuje te, które zaznaczysz; WizTree robi tę samą robotę jako ogólna mapa dysku, jeśli chcesz pełnego obrazu.

• Kasuj node_modules — nigdy package.json ani lockfile
• Reinstaluj przez npm ci: idzie dokładnie według lockfile'a, w przeciwieństwie do npm install
• Odpal npx npkill, by znaleźć i uśmiercić node_modules na wszystkich dyskach
• Trzymaj aktywne projekty poza folderami OneDrive i Dropbox — liczba plików zabija synchronizację
• Projekt martwy? Spakuj go do zipa bez node_modules, potem skasuj folder
• Przy nowych projektach sprawdź pnpm: jeden globalny magazyn, projekty tylko się do niego podpinają

Cache, które kryją się za folderem

Nawet gdy wszystkie node_modules przepadną, npm trzyma drugi skład: cache w %LOCALAPPDATA%\npm-cache, z kopią każdej kiedykolwiek zainstalowanej wersji każdego pakietu — gigabajty, które przez lata rosną bez hamulca. npm cache verify sprząta go bezpiecznie, a ta sama logika dotyczy pnpm store prune i yarn cache clean dla ich magazynów. Samego cache wyłączać nie warto: to właśnie on sprawia, że reinstalacja projektu z pustym cache'em jest ścieżką wyjątkową, a nie standardem. Okresowe zamiatanie śmieci w Kleaner PRO podchwytuje te deweloperskie pamięci podręczne razem ze zwykłymi plikami tymczasowymi — przydaje się, gdy kilka narzędzi po cichu nazbierało na tej samej maszynie.

Pytania i odpowiedzi

Przeczytaj także