Maîtrisez NPM pour gérer les dépendances JavaScript : guide complet des commandes pour installer, mettre à jour, auditer et publier des packages npm.
npm
Gestionnaire de paquets Node.js
-v--version-h--help-l--long--json--parseable--global-g--prefix--no-color--color--depth--save-S--save-dev-D--save-optional-O--save-exact-E--save-bundle-B--no-save
npm --version
Affiche la version de npm
npm -v
Alias court pour --version
npm help
Affiche l'aide générale de npm
<commande>⚠️--usage
npm help install
Affiche l'aide de la commande install
npm init
Initialise un nouveau projet (crée package.json)
--yes-y--force⚠️-f⚠️--scope--workspace-w--include-workspace-root⚠️--install-links--package
npm init -y
Initialise avec les valeurs par défaut
-y--yes
npm init @scope/name
Initialise avec un scope spécifique
--scope
npm init @eslint/config
Initialise ESLint via npm init
npm install
Installe toutes les dépendances listées dans package.json
--save-prod-P--save-dev-D--save-optional-O--save-exact-E--save-bundle-B--no-save--global-g--global-style--legacy-bundling--omit--strict-peer-deps--no-package-lock--ignore-scripts--no-audit--no-bin-links--no-fund⚠️--audit--dry-run⚠️--force⚠️-f⚠️--package-lock-only--prefer-offline--offline--cache--prefix-w--workspace--workspaces--include-workspace-root⚠️--install-links
npm i
Alias de npm install
-S-D-g-P-O-E-B
npm install <package>
Installe un package spécifique
@version@latest@next--save-S--save-dev-D--global-g
npm install express
Installe Express dans les dépendances
--save-S
npm install express@4.18.2
Installe une version spécifique d'Express
@version
npm install express@latest
Installe la dernière version d'Express
@latest
npm install --save-dev typescript
Installe TypeScript comme dépendance de développement
--save-dev-D
npm install -D typescript
Alias court pour --save-dev
-D
npm install -g npm
Met à jour npm globalement
-g--global
npm install -g @angular/cli
Installe Angular CLI globalement
-g
npm install --save-exact express
Installe avec version exacte (sans ^ ou ~)
--save-exact-E
npm install --save-optional chalk
Installe comme dépendance optionnelle
--save-optional-O
npm install --save-bundle webpack
Installe comme bundledDependency
--save-bundle-B
npm install --no-save
Installe sans ajouter à package.json
--no-save
npm install --dry-run
Simule l'installation sans rien modifier
--dry-run⚠️
npm install --force
Force la réinstallation
-f⚠️--force⚠️
npm install --ignore-scripts
Installe sans exécuter les scripts d'installation
--ignore-scripts
npm install --no-audit
Installe sans lancer l'audit de sécurité
--no-audit
npm install --no-fund
Désactive le message de financement
--no-fund⚠️
npm install --package-lock-only
Met à jour package-lock.json sans installer
--package-lock-only
npm install --no-package-lock
Ignore package-lock.json
--no-package-lock
npm install --legacy-peer-deps
Ignore les conflits de peer dependencies
--legacy-peer-deps
npm install --strict-peer-deps
Échoue sur les conflits de peer dependencies
--strict-peer-deps
npm ci
Installation propre depuis package-lock.json (plus rapide, pour CI)
--omit--ignore-scripts--no-audit--no-fund⚠️--dry-run⚠️--workspace-w--workspaces--include-workspace-root⚠️
npm ci --only=production
Installe uniquement les dépendances de production
--only--omit
npm uninstall <package>
Désinstalle un package
--save-S--save-dev-D--save-optional-O--no-save--global-g--workspace-w--workspaces
npm uninstall express
Désinstalle Express
--save-S--save-dev-D
npm uninstall -g @angular/cli
Désinstalle un package global
-g--global
npm rm <package>
Alias de npm uninstall
-S-D-g
npm update
Met à jour tous les packages
--save--save-dev-D--global-g--depth--workspace-w--workspaces
npm update express
Met à jour un package spécifique
--save--save-dev-D
npm update -g npm
Met à jour npm globalement
-g
npm up
Alias de npm update
-g-D
npm outdated
Vérifie les packages obsolètes
--all-a--json--long--parseable--global-g--workspace-w
npm outdated -g
Vérifie les packages globaux obsolètes
-g--global
npm outdated --json
Affiche les packages obsolètes en JSON
--json
npm list
Liste les packages installés
--all-a--json--long--parseable--global-g--depth--prod--development--omit--link--unicode--workspace-w
npm ls
Alias de npm list
-g--depth--json
npm list -g --depth=0
Liste les packages globaux (sans dépendances)
-g--depth
npm list --depth=1
Liste avec profondeur 1
--depth
npm list --json > packages.json
Exporte la liste en JSON
--json
npm search <terme>
Recherche des packages sur le registre npm
--long--json--parseable--no-description--searchopts--searchexclude--registry⚠️--prefer-online--prefer-offline--offline
npm search express
Recherche des packages liés à Express
--long--json
npm view <package>
Affiche les informations d'un package
--json--workspace-w--workspaces
npm view express
Affiche les informations d'Express
--json
npm view express version
Affiche la version d'Express
npm view express versions
Liste toutes les versions d'Express
--json
npm view express dependencies
Affiche les dépendances d'Express
npm info <package>
Alias de npm view
--json
npm show <package>
Alias de npm view
--json
npm run <script>
Exécute un script défini dans package.json
--silent-s--if-present--workspace-w--workspaces--include-workspace-root⚠️--foreground-scripts⚠️--ignore-scripts--script-shell
npm run build
Exécute le script 'build'
--silent-s
npm run dev
Exécute le script 'dev'
--silent-s
npm start
Exécute le script 'start' (raccourci)
----silent-s
npm test
Exécute le script 'test' (raccourci)
----silent-s
npm stop
Exécute le script 'stop' (raccourci)
----silent-s
npm restart
Exécute 'stop' puis 'start'
----silent-s
npm run build -- --watch
Passe des arguments au script (ex: --watch)
--
npm run env
Affiche l'environnement des scripts npm
npm publish
Publie un package sur le registre npm
--access--tag--dry-run⚠️--otp--registry⚠️--scope--provenance--sbom-type--sbom-format⚠️--workspace-w--workspaces--include-workspace-root⚠️
npm publish --access public
Publie un package public (pour les packages scopés)
--access
npm publish --tag beta
Publie avec un tag spécifique
--tag
npm publish --dry-run
Simule la publication
--dry-run⚠️
npm version
Met à jour la version dans package.json
majorminorpatchpremajorpreminorprepatchprereleasefrom-git--allow-same-version--commit-hooks--git-tag-version--json--preid--sign-git-tag--workspace-w--workspaces
npm version patch
Incrémente la version patch (1.0.0 → 1.0.1)
-m--message
npm version minor
Incrémente la version mineure (1.0.0 → 1.1.0)
-m
npm version major
Incrémente la version majeure (1.0.0 → 2.0.0)
-m
npm version prerelease --preid=alpha
Crée une version pre-release (1.0.0 → 1.0.1-alpha.0)
--preid
npm version 2.0.0
Définit une version spécifique
-m
npm audit
Audite les vulnérabilités des dépendances
--audit-level--dry-run⚠️--force⚠️-f⚠️--json--package-lock-only--omit--production--registry⚠️--fix⚠️--workspace-w--workspaces
npm audit fix
Corrige automatiquement les vulnérabilités
--force⚠️-f⚠️--package-lock-only--dry-run⚠️--workspace-w--workspaces
npm audit fix --force
Force la correction (peut inclure des breaking changes)
--force⚠️-f⚠️
npm audit --json
Affiche l'audit au format JSON
--json
npm audit signatures
Vérifie les signatures des packages
--registry⚠️
npm doctor
Diagnostique l'environnement npm
--registry⚠️
npm cache clean
Nettoie le cache npm
--force⚠️-f⚠️
npm cache verify
Vérifie l'intégrité du cache npm
npm cache add <package>
Ajoute un package au cache
npm dedupe
Déduplique les dépendances dans l'arbre node_modules
--global-style--legacy-bundling--strict-peer-deps--no-package-lock--omit--ignore-scripts--workspace-w--workspaces
npm ddp
Alias de npm dedupe
npm prune
Supprime les packages orphelins (non listés dans package.json)
--omit--dry-run⚠️--json--foreground-scripts⚠️--ignore-scripts--workspace-w--workspaces
npm prune --production
Supprime les dépendances de développement
--production
npm shrinkwrap
Crée un fichier npm-shrinkwrap.json (verrouillage pour publication)
npm link
Crée un lien symbolique pour un package local (développement)
--global--install-links--workspace-w--workspaces
npm link <package>
Lie un package global au projet courant
npm unlink
Supprime un lien symbolique
--global--workspace-w--workspaces
npm rebuild
Reconstruit les modules natifs
--global-g--workspace-w--workspaces--ignore-scripts
npm rb
Alias de npm rebuild
-g
npm repo <package>
Ouvre la page du dépôt d'un package dans le navigateur
--browser--workspace-w
npm repo express
Ouvre le dépôt GitHub d'Express
--browser
npm docs <package>
Ouvre la documentation d'un package
--browser--workspace-w
npm docs express
Ouvre la documentation d'Express
--browser
npm home <package>
Ouvre la page d'accueil d'un package
--browser--workspace-w
npm bugs <package>
Ouvre la page des bugs d'un package
--browser--workspace-w
npm config
Gère la configuration npm
setgetdelete⚠️listedit--global-g--location
npm config list
Liste la configuration npm
-g--global--json
npm config get registry
Affiche le registre configuré
npm config set registry https://registry.npmjs.org/
Définit le registre npm
set
npm config set init-author-name "John Doe"
Définit l'auteur par défaut
set
npm config set init-license MIT
Définit la licence par défaut
set
npm config set save-exact true
Active les versions exactes par défaut
set
npm config delete registry
Supprime une configuration
delete⚠️
npm config edit
Ouvre le fichier de configuration dans l'éditeur
-g--global
npm login
Se connecte au registre npm
--registry⚠️--scope--auth-type--auth-type=web--auth-type=legacy
npm adduser
Alias de npm login
--registry⚠️--scope
npm logout
Se déconnecte du registre npm
--registry⚠️--scope
npm whoami
Affiche l'utilisateur npm connecté
--registry⚠️
npm token
Gère les tokens d'authentification
listcreaterevoke--read-only⚠️--cidr
npm token list
Liste les tokens actifs
--registry⚠️
npm token create --read-only
Crée un token en lecture seule
--read-only⚠️--cidr
npm token revoke <token_id>
Révoque un token
npm access
Gère les accès des packages publiés
publicrestrictedgrantrevokels-packagesls-collaboratorsedit
npm access public <package>
Rend un package scopé public
npm access grant <user> <package>
Donne accès à un utilisateur
npm access ls-packages
Liste les packages accessibles
--user--registry⚠️
npm owner
Gère les propriétaires d'un package
addrm⚠️ls
npm owner add <user> <package>
Ajoute un propriétaire
--registry⚠️
npm owner rm <user> <package>
Retire un propriétaire
npm owner ls <package>
Liste les propriétaires
npm team
Gère les équipes npm
createdestroyaddrm⚠️ls
npm team create <scope:team>
Crée une équipe
--registry⚠️
npm team add <scope:team> <user>
Ajoute un utilisateur à une équipe
npm pack
Crée un tarball du package (pour test local)
--dry-run⚠️--json--pack-destination
npm pack --pack-destination ./local-packages
Crée le tarball dans un dossier spécifique
--pack-destination
npm prefix
Affiche le préfixe d'installation
--global-g
npm root
Affiche le chemin de node_modules
--global-g
npm bin
Affiche le dossier des exécutables npm
--global-g
npm explore <package>
Explore un package installé (ouvre un shell)
--
npm explore express -- ls
Exécute ls dans le dossier d'Express
--
npm exec
Exécute une commande depuis un package npm
--workspace-w--workspaces--include-workspace-root⚠️-c--call--yes-y--no-n--package-p
npm exec -- cowsay "Hello"
Exécute cowsay sans l'installer
----yes-y
npm exec -c "tsc --version"
Exécute une commande avec -c
-c--call
npx <commande>
Exécute une commande npm (ancien nom, alias de npm exec)
--package-p--cache--userconfig--call-c--shell--yes-y--no-n--quiet-q--ignore-existing--node-arg-n
npx create-react-app my-app
Crée une app React avec create-react-app
npx eslint --init
Initialise ESLint
npx --yes cowsay Hello
Exécute sans confirmation
-y--yes
npm diff
Affiche les différences de registre entre packages
--diff--name-only--diff-name-only--diff-unified--diff-ignore-all-space--diff-no-prefix--diff-src-prefix--diff-dst-prefix--diff-text--global-g--tag--workspace-w
npm diff express@4.17.1 express@4.18.2
Compare deux versions d'Express
--diff
npm find-dupes
Trouve les dépendances dupliquées
--global-g
npm explain <package>
Explique pourquoi un package est installé
--global-g
npm why <package>
Alias de npm explain
-g
