node_modules sur Mac : c'est quoi, peut-on le supprimer ?

Où il se trouve

De quoi il s'agit

Quand vous exécutez npm install, yarn ou pnpm install dans un projet JavaScript ou TypeScript, le gestionnaire de paquets lit package.json et place chaque dépendance, ainsi que chaque dépendance de ces dépendances, dans un dossier node_modules à l'intérieur du projet.

Il devient volumineux parce que les projets modernes font appel à des centaines, voire des milliers de paquets, dont certains contiennent des binaires compilés. Chaque projet a sa propre copie : dix projets signifient donc dix dossiers node_modules, y compris pour des projets que vous n'avez pas ouverts depuis des années.

Rien de ce que vous avez écrit ne se trouve dans node_modules. Ce qui compte, c'est votre code, package.json et le fichier de verrouillage (lockfile), et ils suffisent à le reconstruire.

Quelle taille il peut atteindre

Couramment des centaines de Mo par projet, et plus d'un Go pour les grosses apps et les monorepos.

Comment le vider à la main

1. Arrêtez tout serveur de développement ou tout build en cours dans le projet.
2. Ouvrez Terminal et placez-vous dans le dossier du projet.
3. Exécutez la commande ci-dessous. Elle supprime uniquement le dossier node_modules du dossier courant : vérifiez donc d'abord où vous êtes avec pwd.
4. Quand vous reprendrez le projet, exécutez npm install, yarn install ou pnpm install pour le restaurer.

rm -rf node_modules

Ce qui se passe ensuite

Le projet ne s'exécutera pas et ne se compilera pas tant que vous n'aurez pas réinstallé les dépendances. Avec un fichier de verrouillage, vous retrouvez les mêmes versions, et la réinstallation est plus rapide si le cache du gestionnaire de paquets est encore sur le disque.

Comment Diskzy le traite

Diskzy trouve les dossiers de build de projet comme node_modules dans l'onglet Clean up (nettoyage). Un dossier reste décoché si son projet a été modifié au cours des 14 derniers jours.

Guides associés

• npm cache~/.npm/_cacache
• pnpm store~/Library/pnpm/store
• Yarn cache~/Library/Caches/Yarn