Cheatsheet npm / pnpm

npm install ou npm i

Installe toutes les dépendances déclarées dans package.json et crée ou actualise le fichier de verrouillage package-lock.json.

npm install package

Installe un paquet et l'enregistre dans les dépendances de production (dependencies). L'option --save est implicite depuis npm 5.

npm install -D package

Installe un paquet dans les dépendances de développement (devDependencies) : outillage, tests, compilation. Équivalent long : --save-dev.

npm ci

Vide node_modules/ et installe strictement les versions verrouillées : en intégration continue pour des builds reproductibles.

npm install -g package

Installe un paquet globalement : il devient disponible comme commande système, en dehors de tout projet.

npm uninstall package

Désinstalle un paquet et le retire automatiquement de package.json et du fichier de verrouillage.

npm outdated

Liste les dépendances obsolètes en affichant côte à côte la version installée, la version souhaitée et la dernière publiée.

npm update

Met à jour les dépendances de production dans les limites autorisées par package.json (^, ~). Ajouter --dev pour celles de développement.

npx npm-check -u

Interface avancée et interactive pour choisir, paquet par paquet, les mises à jour à appliquer.

npx npm-check-updates

Réécrit package.json vers les dernières versions publiées (latest), au-delà des plages autorisées.

npx taze major

Alternative moderne : met à jour jusqu'à la dernière version stable. Remplacer par minor pour rester prudent.

npx depcheck

Analyse le code source pour identifier les dépendances inutilisées (déclarées dans package.json mais jamais importées) ou manquantes.

pnpm install ou pnpm i

Même rôle que npm install, mais les paquets sont liés depuis un magasin global : installations plus rapides et espace disque fortement réduit.

pnpm add package

Ajoute une dépendance. Suffixer par -D pour le développement, -g pour une installation globale.

pnpm remove package

Retire une dépendance du projet et du fichier de verrouillage.

pnpm update --latest --interactive

Propose les montées de version jusqu'à la dernière publiée, avec sélection manuelle des paquets concernés.

pnpm dlx package

Exécute un paquet sans l'installer durablement. C'est l'équivalent pnpm de npx.

npm run

Sans argument, liste toutes les tâches et scripts déclarés dans la section scripts de package.json.

npm run script

Exécute un script du projet (ex : dev, build, lint). Les binaires locaux de node_modules/.bin sont automatiquement accessibles.

npm run script -- --port=4000

Le double tiret isolé transmet les options suivantes à la commande du script, et non à npm lui-même.

npx package

Exécute un paquet sans l'installer durablement : il est téléchargé dans un cache temporaire puis lancé.

npm install -g serve

Puis serve dans un dossier local pour instancier immédiatement un mini serveur HTTP statique.

npm ls package

Affiche où un paquet est installé dans l'arbre des dépendances et par qui il est réclamé. Utile en cas de conflit de versions.

npm root et npm root -g

Retournent le chemin du dossier node_modules local puis global. Pratique pour retrouver où npm installe réellement.

npm view package versions

Interroge le registre et affiche toutes les versions publiées d'un paquet, sans rien installer.

npm audit

Signale les vulnérabilités connues des dépendances. npm audit fix corrige celles qui ne cassent pas la compatibilité.

npm cache clean --force

Vide le cache npm. Dernier recours face à des erreurs d'installation persistantes ou incohérentes.

nvm install 26 puis nvm use 26

Installe puis active une version précise de Node avec nvm (versions Linux/macOS et Windows distinctes).

.nvmrc puis nvm use

Un fichier à la racine contenant le numéro de version suffit : toute l'équipe bascule sur la même version de Node sans se poser de question.

corepack enable

Active les gestionnaires de paquets livrés avec Node (pnpm, yarn) sans aucune installation globale supplémentaire.

"packageManager": "pnpm@11.0.0"

Ce champ de package.json fige le gestionnaire et sa version pour tout le projet, y compris en intégration continue.

Set-ExecutionPolicy Unrestricted

Sous Windows 11, si le système refuse d'exécuter pnpm, assouplir les restrictions depuis un shell administrateur.