Comment supprimer un package NPM (local et global) et corriger les erreurs courantes

Si vous devez supprimer les dépendances d’un package NPM d’un projet ou retirer un outil CLI de votre système, la procédure est généralement simple. Cependant, il peut devenir déroutant si vous mélangez installations locales et globales. Suivez ce guide pas à pas pour bien comprendre et agir correctement.

Avant toute chose, il est nécessaire de comprendre les types de packages NPM. Cette distinction est essentielle pour éviter les erreurs.

Il existe deux types principaux d’installations :

• Packages locaux : installés dans le dossier d’un projet spécifique

• Packages globaux : installés au niveau du système pour une utilisation en ligne de commande

Lorsque vous supprimez un package NPM, la commande à utiliser dépend de son type d’installation.

• Pour un package local, NPM met généralement à jour automatiquement les fichiers du projet.

• Pour un package global, vous devez utiliser une option spécifique (-g).

Étape 1 : Ouvrir le terminal

• Windows : appuyez sur Win + R, tapez cmd, puis appuyez sur Entrée

• macOS : appuyez sur Command + Espace, tapez “Terminal” et ouvrez-le

• Linux : appuyez sur Ctrl + Alt + T (dans la plupart des distributions Linux)

Étape 2 : Accéder au dossier de votre projet

Vous devez maintenant ouvrir le dossier qui contient votre projet Node.js et le fichier package.json.

Par exemple, si votre projet se trouve ici :

C:\my-project
Tapez la commande suivante dans le terminal puis appuyez sur Entrée :
cd C:\my-project

Cette commande permet simplement de se déplacer vers le bon dossier dans le terminal.

Astuce :

Votre dossier de projet contient généralement des fichiers ou dossiers comme :

• package.json

• package-lock.json

• node_modules

• src

Si vous ne savez pas où vous êtes :

• Tapez pwd sur macOS/Linux

• Tapez cd sans argument sur Windows

Le terminal affichera alors le chemin actuel.

Étape 3 : Désinstaller le package NPM

Dans la même fenêtre du terminal, tapez :

npm uninstall package-name

Par exemple :

npm uninstall lodash

Puis appuyez sur Entrée.

NPM supprimera automatiquement le dossier lodash du dossier node_modules.

Le package sera également retiré automatiquement des fichiers :

• package.json

• package-lock.json

Si le package a été installé globalement sur votre système, ajoutez l’option -g :

npm uninstall -g package-name

Par exemple :

npm uninstall -g typescript

Contrairement à une désinstallation locale, vous pouvez exécuter cette commande depuis n’importe quel dossier. Il n’est pas nécessaire d’être dans un projet Node.js.

Si la commande npm uninstall ne fonctionne pas, voici les causes les plus fréquentes et leurs solutions :

1. Erreur dans le nom du package

Une faute de frappe dans le nom du package peut empêcher la désinstallation. Vérifiez l’orthographe exacte dans les dépendances du fichier package.json.

2. Package utilisé par un autre

Certains packages sont installés comme dépendances d’autres modules. Dans ce cas, NPM peut empêcher leur suppression automatique. Vous pouvez essayer :

npm uninstall --depth=0 package-name

3. Fichier de verrouillage corrompu

Supprimez les éléments suivants :

• node_modules

• package-lock.json

Puis exécutez :

• npm install

Cela reconstruira proprement les dépendances du projet.

4. Problème de cache NPM

Nettoyez le cache avec :

npm cache clean --force

5. Solution manuelle (dernier recours)

Si aucune solution ne fonctionne :

1. Supprimez manuellement le dossier du package dans node_modules

2. Retirez son entrée dans : 
   

   package.json

   package-lock.json

3. Exécutez ensuite :npm install

Cela permettra de resynchroniser correctement les dépendances du projet.

Pour éviter les problèmes de dépendances :

• Vérifiez si le package est local ou global

• Assurez-vous d’être dans le bon dossier de projet

• Contrôlez si d’autres packages en dépendent

• Relisez package.json après suppression

• Réinstallez les dépendances si le projet rencontre des erreurs

Ces vérifications simples peuvent vous faire gagner beaucoup de temps, surtout sur des projets anciens ou collaboratifs.

Les commandes de désinstallation NPM fonctionnent très bien pour gérer les dépendances Node.js. Toutefois, il arrive que certaines applications Windows soient plus difficiles à supprimer proprement, laissant des fichiers résiduels ou des entrées inutiles.

Dans ce cas, un outil dédié comme IObit Uninstaller peut être utile : il permet de forcer la suppression des programmes, de nettoyer les fichiers restants et même de désinstaller plusieurs applications en une seule fois.

Pour les packages NPM, privilégiez toujours la ligne de commande. Mais pour le nettoyage global de votre système, il est bon d’avoir une solution complémentaire.

IObit Uninstaller Free

Désinstallez les programmes récalcitrants et supprimez les fichiers résiduels, y compris les applis Windows et extensions.

Télécharger gratuitement