npm est le gestionnaire de paquets livré avec Node.js. Tu l’utilises tous les jours, mais connais-tu la différence entre npm install et npm ci, ou comment savoir pourquoi un paquet est installé ? Voici les commandes essentielles, classées par usage, avec des exemples prêts à copier.
Cette antisèche couvre les commandes de la CLI npm documentées sur docs.npmjs.com. Garde-la sous la main pendant tes projets Node.js.

Initialiser un projet
npm init # Questions interactives
npm init -y # package.json avec les valeurs par défaut
npm pkg set type=module # Modifier une clé du package.json
npm pkg get version # Lire une cléterminalInstaller des dépendances
| Commande | Rôle |
|---|---|
npm install (npm i) | Installe toutes les dépendances du package.json |
npm i express | Ajoute une dépendance de production |
npm i -D eslint | Ajoute une dépendance de développement |
npm i [email protected] | Installe une version précise |
npm i -g nodemon | Installe un outil globalement |
npm uninstall express | Supprime une dépendance |
npm ci | Installation propre et exacte depuis le package-lock.json |
npm ci supprime node_modules et installe exactement les versions du lockfile, sans le modifier. C’est la commande à utiliser en intégration continue et en production. (source : npm ci)
Mettre à jour
npm outdated # Liste les paquets en retard
npm update # Met à jour dans les plages du package.json
npm i express@latest # Passe à la dernière version (même majeure)
npm dedupe # Réduit les doublons dans l’arbreterminalInspecter les dépendances
npm ls # Dépendances directes
npm ls --all # Arbre complet
npm explain lodash # Pourquoi ce paquet est installé
npm view express versions # Versions publiées
npm view express version # Dernière versionterminalSécuriser son projet
npm audit # Rapport de vulnérabilités
npm audit fix # Corrige ce qui peut l’être sans casser
npm audit --omit=dev # Ignore les dépendances de dev
npm ci --ignore-scripts # Installe sans lancer les scriptsterminall’option --force peut installer des versions majeures incompatibles. Lis le rapport, puis teste après la mise à jour. (source : npm audit)
Pourquoi c’est important ? Relis notre veille sur le ver Shai-Hulud 2.0.
Lancer des scripts
npm run # Liste les scripts du package.json
npm run dev # Lance le script "dev"
npm start # Raccourci de npm run start
npm test # Raccourci de npm run test
npm run build -- --watch # Passe des arguments au scriptterminalnpx : exécuter sans installer
npx create-vite@latest mon-projet
npx eslint .
npm exec -- prettier --write .terminalConfiguration et cache
npm config list
npm config get registry
npm config set init-author-name "LM-Code"
npm cache verify
npm cache clean --force
npm doctor # Vérifie l’environnement npmterminalPublier un paquet
npm login
npm whoami
npm version patch # 1.0.0 → 1.0.1 (+ commit et tag Git)
npm version minor # 1.0.1 → 1.1.0
npm publish --access public
npm deprecate [email protected] "Utilise la 1.1.0"terminalLes commandes npm en un coup d’œil
FAQ
Quelle différence entre npm install et npm ci ?
npm install peut mettre à jour le package-lock.json. npm ci installe exactement les versions du lockfile, après avoir supprimé node_modules.
Comment savoir pourquoi un paquet est installé ?
Avec npm explain nom-du-paquet, qui affiche la chaîne de dépendances.
Comment vérifier les failles de mes dépendances ?
Avec npm audit, puis npm audit fix pour appliquer les correctifs compatibles.
Que fait npx ?
Il exécute un paquet sans l’installer globalement, en le téléchargeant si besoin.
Antisèche npm : le résumé à retenir
- npm ci en CI et en production.
- npm outdated avant chaque mise à jour.
- npm audit régulièrement.
- npm explain pour comprendre ton arbre de dépendances.
Conclusion
Avec ces commandes, tu couvres l’essentiel du travail quotidien avec npm. Ajoute cette page à tes favoris pour la retrouver facilement.
Sources
- Documentation npm : CLI Commands
- Documentation npm : npm ci
- Documentation npm : npm audit
- Documentation npm : npm explain
- Documentation npm : npm version

