Comment désinstaller proprement des npm et ses packages ?
Node Package Manager (npm) est l’outil de référence pour gérer les dépendances d’un projet Node.js. Mais que faire quand on veut se débarrasser de NPM ou de l’un de ses packages devenu inutiles ?
Debugbar vous a préparé un guide complet pour désinstaller proprement NPM et les packages associés, que ce soit des dépendances locales à un projet ou des packages installés globalement.
Supprimer npm et Node.js
Vous voulez complètement supprimer Node.js et NPM de votre appareil ? Voici la marche à suivre pour y parvenir selon le système sur lequel vous travaillez.
Désinstaller Node.js et npm sur Windows
La meilleure solution pour désinstaller node.js sur Winsdows est d’utiliser le panneau de configuration :
- Ouvrez le panneau de configuration.
- Cliquez sur Programmes > Programmes et applications (ou Paramètres > Apps pour Windows 11).
- Dans la liste des programmes, repérez Node.js.
- Cliquez droit dessus et choisissez “Désinstaller“.
- Suivez les instructions et redémarrez votre PC.
Vous pouvez aussi passer par l’invite de commande (recherchez “cmd”) en lançant msiexec /x {no-de-version-node}. Vous trouverez le numéro de la version installée dans le répertoire C:\Program Files (x86)\nodejs ou le répertoire C:\Program Files\nodejs.
Désinstaller Node.js sur macOS
Pour désinstaller Node.js sur votre Mac vous devrez :
- ouvrir le Terminal et entrer la commande :
- sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules/npm,lib/node,share/man/*/node.*}
Cela supprimera Node.js, npm et les dossiers associés.
Vous pouvez aussi choisir la méthode classique :
- Appuyez simultanément sur Cmd + Shift + G pour ouvrir l’outil d’exécution.
- Taper /usr/local/lib
- Trouver le dossier node_modules, faire un clic droit et cliquer sur “Mettre à la corbeille”.
Enfin redémarrez votre Mac et le tour est joué.
Désinstaller Node.js sur Linux (Ubuntu/Debian)
Si vous êtes sur Linux, vous devez :
- Ouvrir un terminal et exécuter :
- sudo apt-get remove nodejs npm
- Nettoyer les paquets inutilisés avec :
- sudo apt autoremove
Vous ne voulez pas complètement désinstaller NPM ? Alors voici comment faire pour désinstaller uniquement les packages.
Désinstaller un package local d’un projet Node.js
La méthode la plus simple pour supprimer un package npm d’un projet est d’utiliser la commande npm uninstall.
Pour ce faire, il vous suffit simplement d’aller à la racine du projet (là où se trouve le fichier package.json) et de taper :
- npm uninstall <nom-du-package>
Par exemple, si vous souhaitez désinstaller le package lodash, vous devrez taper :
- npm uninstall lodash
Cela supprimera alors lodash du dossier node_modules et mettra à jour le package.json et le package-lock.json en conséquence. Si le package faisait partie des dependencies, il sera retiré de cette section.
Désinstaller un package sans toucher au package.json
Si vous souhaitez désinstaller un package sans modifier le package.json, il vous suffira alors de rajouter l’option –no-save :
- npm uninstall –no-save <nom-du-package>
Le package sera ainsi supprimé du node_modules mais restera listé dans les dépendances du package.json.
Vérifier qu’un package a bien été désinstallé
Pour s’assurer que npm uninstall a bien fait le ménage, vous pouvez inspecter le contenu du dossier node_modules :
- Sur Unix/macOS, vous devrez rentrer la commande suivante : ls node_modules
- Sur Windows il faudra taper cette commande : dir node_modules
Vous devriez alors, si tout s’est bien passé, constater que le dossier du package a disparu.
Désinstaller une dépendance de développement (devDependency)
Les devDependencies sont des packages utilisés uniquement pendant la phase de développement.
Ces “dependencies” peuvent aussi être désinstallés très facilement grâce à l’ajout du flag –save-dev (ou -D en version courte) :
- npm uninstall –save-dev <nom-du-package>
Ou :
- npm uninstall -D <nom-du-package>
Cela retirera la dépendance de développement de la section devDependencies du package.json en plus de la supprimer du dossier node_modules.
Désinstaller un package npm global
Les packages installés globalement avec -g ne sont pas rattachés à un projet mais dépendent du système. Pour en désinstaller un, il faudra donc utiliser npm uninstall avec l’option -g :
- npm uninstall -g <nom-du-package>
Le package global sera alors supprimé.
En bref : la commande npm uninstall est votre meilleure amie pour supprimer proprement les packages locaux et globaux devenus superflus. Manipulez-la avec les bonnes options selon vos besoins. Et si vous voulez repartir d’un environnement Node.js vierge, suivez les étapes de désinstallation complète pour votre OS. Faites le tri dans vos node_modules, votre disque dur vous remerciera !
