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.

📦 npm🧾 35 commandes📋 Prêt à copier⏱️ 6 min de lecture

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.

Antisèche des commandes npm
Les commandes npm classées par usage.

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é
terminal

Installer des dépendances

CommandeRôle
npm install (npm i)Installe toutes les dépendances du package.json
npm i expressAjoute une dépendance de production
npm i -D eslintAjoute une dépendance de développement
npm i [email protected]Installe une version précise
npm i -g nodemonInstalle un outil globalement
npm uninstall expressSupprime une dépendance
npm ciInstallation propre et exacte depuis le package-lock.json
💡
npm install ou npm ci ?

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’arbre
terminal

Inspecter 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 version
terminal

Sé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 scripts
terminal
⚠️
Évite npm audit fix –force à l’aveugle :

l’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 script
terminal

npx : exécuter sans installer

npx create-vite@latest mon-projet
npx eslint .
npm exec -- prettier --write .
terminal

Configuration 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 npm
terminal

Publier 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"
terminal

Les commandes npm en un coup d’œil

📥 Installernpm i, npm i -D, npm ci, npm uninstall
🔄 Mettre à journpm outdated, npm update, npm dedupe
🔎 Inspecternpm ls, npm explain, npm view
🛡️ Sécurisernpm audit, npm audit fix, –ignore-scripts
▶️ Exécuternpm run, npm start, npm test, npx
🚀 Publiernpm version, npm publish, npm deprecate

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

Comments

No comments yet. Why don’t you start the discussion?

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *