Commandes NPM - Guide complet package manager Node.js

🏷️ Lignes des commandes 📅 02/03/2026 09:00:00 👤 Mezgani said
Npm Package Manager Node.js Dépendances Packages Javascript Versioning Npm Scripts Registry

Maîtrisez NPM pour gérer les dépendances JavaScript. Guide complet des commandes pour installer, mettre à jour et publier des packages.

Ligne de commande :
npm
Description :

Gestionnaire de paquets Node.js

Options :
  • -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

Ligne de commande :
npm --version
Description :

Affiche la version de npm

Ligne de commande :
npm -v
Description :

Alias court pour --version

Ligne de commande :
npm help
Description :

Affiche l'aide générale de npm

Options :
  • <commande>
  • --usage

Ligne de commande :
npm help install
Description :

Affiche l'aide de la commande install

Ligne de commande :
npm init
Description :

Initialise un nouveau projet (crée package.json)

Options :
  • --yes
  • -y
  • --force
  • -f
  • --scope
  • --workspace
  • -w
  • --include-workspace-root
  • --install-links
  • --package

Ligne de commande :
npm init -y
Description :

Initialise avec les valeurs par défaut

Options :
  • -y
  • --yes

Ligne de commande :
npm init @scope/name
Description :

Initialise avec un scope spécifique

Options :
  • --scope

Ligne de commande :
npm init @eslint/config
Description :

Initialise ESLint via npm init

Ligne de commande :
npm install
Description :

Installe toutes les dépendances listées dans package.json

Options :
  • --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

Ligne de commande :
npm i
Description :

Alias de npm install

Options :
  • -S
  • -D
  • -g
  • -P
  • -O
  • -E
  • -B

Ligne de commande :
npm install <package>
Description :

Installe un package spécifique

Options :
  • @version
  • @latest
  • @next
  • --save
  • -S
  • --save-dev
  • -D
  • --global
  • -g

Ligne de commande :
npm install express
Description :

Installe Express dans les dépendances

Options :
  • --save
  • -S

Ligne de commande :
npm install express@4.18.2
Description :

Installe une version spécifique d'Express

Options :
  • @version

Ligne de commande :
npm install express@latest
Description :

Installe la dernière version d'Express

Options :
  • @latest

Ligne de commande :
npm install --save-dev typescript
Description :

Installe TypeScript comme dépendance de développement

Options :
  • --save-dev
  • -D

Ligne de commande :
npm install -D typescript
Description :

Alias court pour --save-dev

Options :
  • -D

Ligne de commande :
npm install -g npm
Description :

Met à jour npm globalement

Options :
  • -g
  • --global

Ligne de commande :
npm install -g @angular/cli
Description :

Installe Angular CLI globalement

Options :
  • -g

Ligne de commande :
npm install --save-exact express
Description :

Installe avec version exacte (sans ^ ou ~)

Options :
  • --save-exact
  • -E

Ligne de commande :
npm install --save-optional chalk
Description :

Installe comme dépendance optionnelle

Options :
  • --save-optional
  • -O

Ligne de commande :
npm install --save-bundle webpack
Description :

Installe comme bundledDependency

Options :
  • --save-bundle
  • -B

Ligne de commande :
npm install --no-save
Description :

Installe sans ajouter à package.json

Options :
  • --no-save

Ligne de commande :
npm install --dry-run
Description :

Simule l'installation sans rien modifier

Options :
  • --dry-run

Ligne de commande :
npm install --force
Description :

Force la réinstallation

Options :
  • -f
  • --force

Ligne de commande :
npm install --ignore-scripts
Description :

Installe sans exécuter les scripts d'installation

Options :
  • --ignore-scripts

Ligne de commande :
npm install --no-audit
Description :

Installe sans lancer l'audit de sécurité

Options :
  • --no-audit

Ligne de commande :
npm install --no-fund
Description :

Désactive le message de financement

Options :
  • --no-fund

Ligne de commande :
npm install --package-lock-only
Description :

Met à jour package-lock.json sans installer

Options :
  • --package-lock-only

Ligne de commande :
npm install --no-package-lock
Description :

Ignore package-lock.json

Options :
  • --no-package-lock

Ligne de commande :
npm install --legacy-peer-deps
Description :

Ignore les conflits de peer dependencies

Options :
  • --legacy-peer-deps

Ligne de commande :
npm install --strict-peer-deps
Description :

Échoue sur les conflits de peer dependencies

Options :
  • --strict-peer-deps

Ligne de commande :
npm ci
Description :

Installation propre depuis package-lock.json (plus rapide, pour CI)

Options :
  • --omit
  • --ignore-scripts
  • --no-audit
  • --no-fund
  • --dry-run
  • --workspace
  • -w
  • --workspaces
  • --include-workspace-root

Ligne de commande :
npm ci --only=production
Description :

Installe uniquement les dépendances de production

Options :
  • --only
  • --omit

Ligne de commande :
npm uninstall <package>
Description :

Désinstalle un package

Options :
  • --save
  • -S
  • --save-dev
  • -D
  • --save-optional
  • -O
  • --no-save
  • --global
  • -g
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm uninstall express
Description :

Désinstalle Express

Options :
  • --save
  • -S
  • --save-dev
  • -D

Ligne de commande :
npm uninstall -g @angular/cli
Description :

Désinstalle un package global

Options :
  • -g
  • --global

Ligne de commande :
npm rm <package>
Description :

Alias de npm uninstall

Options :
  • -S
  • -D
  • -g

Ligne de commande :
npm update
Description :

Met à jour tous les packages

Options :
  • --save
  • --save-dev
  • -D
  • --global
  • -g
  • --depth
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm update express
Description :

Met à jour un package spécifique

Options :
  • --save
  • --save-dev
  • -D

Ligne de commande :
npm update -g npm
Description :

Met à jour npm globalement

Options :
  • -g

Ligne de commande :
npm up
Description :

Alias de npm update

Options :
  • -g
  • -D

Ligne de commande :
npm outdated
Description :

Vérifie les packages obsolètes

Options :
  • --all
  • -a
  • --json
  • --long
  • --parseable
  • --global
  • -g
  • --workspace
  • -w

Ligne de commande :
npm outdated -g
Description :

Vérifie les packages globaux obsolètes

Options :
  • -g
  • --global

Ligne de commande :
npm outdated --json
Description :

Affiche les packages obsolètes en JSON

Options :
  • --json

Ligne de commande :
npm list
Description :

Liste les packages installés

Options :
  • --all
  • -a
  • --json
  • --long
  • --parseable
  • --global
  • -g
  • --depth
  • --prod
  • --development
  • --omit
  • --link
  • --unicode
  • --workspace
  • -w

Ligne de commande :
npm ls
Description :

Alias de npm list

Options :
  • -g
  • --depth
  • --json

Ligne de commande :
npm list -g --depth=0
Description :

Liste les packages globaux (sans dépendances)

Options :
  • -g
  • --depth

Ligne de commande :
npm list --depth=1
Description :

Liste avec profondeur 1

Options :
  • --depth

Ligne de commande :
npm list --json > packages.json
Description :

Exporte la liste en JSON

Options :
  • --json

Ligne de commande :
npm search <terme>
Description :

Recherche des packages sur le registre npm

Options :
  • --long
  • --json
  • --parseable
  • --no-description
  • --searchopts
  • --searchexclude
  • --registry
  • --prefer-online
  • --prefer-offline
  • --offline

Ligne de commande :
npm search express
Description :

Recherche des packages liés à Express

Options :
  • --long
  • --json

Ligne de commande :
npm view <package>
Description :

Affiche les informations d'un package

Options :
  • --json
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm view express
Description :

Affiche les informations d'Express

Options :
  • --json

Ligne de commande :
npm view express version
Description :

Affiche la version d'Express

Ligne de commande :
npm view express versions
Description :

Liste toutes les versions d'Express

Options :
  • --json

Ligne de commande :
npm view express dependencies
Description :

Affiche les dépendances d'Express

Ligne de commande :
npm info <package>
Description :

Alias de npm view

Options :
  • --json

Ligne de commande :
npm show <package>
Description :

Alias de npm view

Options :
  • --json

Ligne de commande :
npm run <script>
Description :

Exécute un script défini dans package.json

Options :
  • --silent
  • -s
  • --if-present
  • --workspace
  • -w
  • --workspaces
  • --include-workspace-root
  • --foreground-scripts
  • --ignore-scripts
  • --script-shell

Ligne de commande :
npm run build
Description :

Exécute le script 'build'

Options :
  • --silent
  • -s

Ligne de commande :
npm run dev
Description :

Exécute le script 'dev'

Options :
  • --silent
  • -s

Ligne de commande :
npm start
Description :

Exécute le script 'start' (raccourci)

Options :
  • --
  • --silent
  • -s

Ligne de commande :
npm test
Description :

Exécute le script 'test' (raccourci)

Options :
  • --
  • --silent
  • -s

Ligne de commande :
npm stop
Description :

Exécute le script 'stop' (raccourci)

Options :
  • --
  • --silent
  • -s

Ligne de commande :
npm restart
Description :

Exécute 'stop' puis 'start'

Options :
  • --
  • --silent
  • -s

Ligne de commande :
npm run build -- --watch
Description :

Passe des arguments au script (ex: --watch)

Options :
  • --

Ligne de commande :
npm run env
Description :

Affiche l'environnement des scripts npm

Ligne de commande :
npm publish
Description :

Publie un package sur le registre npm

Options :
  • --access
  • --tag
  • --dry-run
  • --otp
  • --registry
  • --scope
  • --provenance
  • --sbom-type
  • --sbom-format
  • --workspace
  • -w
  • --workspaces
  • --include-workspace-root

Ligne de commande :
npm publish --access public
Description :

Publie un package public (pour les packages scopés)

Options :
  • --access

Ligne de commande :
npm publish --tag beta
Description :

Publie avec un tag spécifique

Options :
  • --tag

Ligne de commande :
npm publish --dry-run
Description :

Simule la publication

Options :
  • --dry-run

Ligne de commande :
npm version
Description :

Met à jour la version dans package.json

Options :
  • major
  • minor
  • patch
  • premajor
  • preminor
  • prepatch
  • prerelease
  • from-git
  • --allow-same-version
  • --commit-hooks
  • --git-tag-version
  • --json
  • --preid
  • --sign-git-tag
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm version patch
Description :

Incrémente la version patch (1.0.0 → 1.0.1)

Options :
  • -m
  • --message

Ligne de commande :
npm version minor
Description :

Incrémente la version mineure (1.0.0 → 1.1.0)

Options :
  • -m

Ligne de commande :
npm version major
Description :

Incrémente la version majeure (1.0.0 → 2.0.0)

Options :
  • -m

Ligne de commande :
npm version prerelease --preid=alpha
Description :

Crée une version pre-release (1.0.0 → 1.0.1-alpha.0)

Options :
  • --preid

Ligne de commande :
npm version 2.0.0
Description :

Définit une version spécifique

Options :
  • -m

Ligne de commande :
npm audit
Description :

Audite les vulnérabilités des dépendances

Options :
  • --audit-level
  • --dry-run
  • --force
  • -f
  • --json
  • --package-lock-only
  • --omit
  • --production
  • --registry
  • --fix
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm audit fix
Description :

Corrige automatiquement les vulnérabilités

Options :
  • --force
  • -f
  • --package-lock-only
  • --dry-run
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm audit fix --force
Description :

Force la correction (peut inclure des breaking changes)

Options :
  • --force
  • -f

Ligne de commande :
npm audit --json
Description :

Affiche l'audit au format JSON

Options :
  • --json

Ligne de commande :
npm audit signatures
Description :

Vérifie les signatures des packages

Options :
  • --registry

Ligne de commande :
npm doctor
Description :

Diagnostique l'environnement npm

Options :
  • --registry

Ligne de commande :
npm cache clean
Description :

Nettoie le cache npm

Options :
  • --force
  • -f

Ligne de commande :
npm cache verify
Description :

Vérifie l'intégrité du cache npm

Ligne de commande :
npm cache add <package>
Description :

Ajoute un package au cache

Ligne de commande :
npm dedupe
Description :

Déduplique les dépendances dans l'arbre node_modules

Options :
  • --global-style
  • --legacy-bundling
  • --strict-peer-deps
  • --no-package-lock
  • --omit
  • --ignore-scripts
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm ddp
Description :

Alias de npm dedupe

Ligne de commande :
npm prune
Description :

Supprime les packages orphelins (non listés dans package.json)

Options :
  • --omit
  • --dry-run
  • --json
  • --foreground-scripts
  • --ignore-scripts
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm prune --production
Description :

Supprime les dépendances de développement

Options :
  • --production

Ligne de commande :
npm shrinkwrap
Description :

Crée un fichier npm-shrinkwrap.json (verrouillage pour publication)

Ligne de commande :
npm link
Description :

Crée un lien symbolique pour un package local (développement)

Options :
  • --global
  • --install-links
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm link <package>
Description :

Lie un package global au projet courant

Ligne de commande :
npm unlink
Description :

Supprime un lien symbolique

Options :
  • --global
  • --workspace
  • -w
  • --workspaces

Ligne de commande :
npm rebuild
Description :

Reconstruit les modules natifs

Options :
  • --global
  • -g
  • --workspace
  • -w
  • --workspaces
  • --ignore-scripts

Ligne de commande :
npm rb
Description :

Alias de npm rebuild

Options :
  • -g

Ligne de commande :
npm repo <package>
Description :

Ouvre la page du dépôt d'un package dans le navigateur

Options :
  • --browser
  • --workspace
  • -w

Ligne de commande :
npm repo express
Description :

Ouvre le dépôt GitHub d'Express

Options :
  • --browser

Ligne de commande :
npm docs <package>
Description :

Ouvre la documentation d'un package

Options :
  • --browser
  • --workspace
  • -w

Ligne de commande :
npm docs express
Description :

Ouvre la documentation d'Express

Options :
  • --browser

Ligne de commande :
npm home <package>
Description :

Ouvre la page d'accueil d'un package

Options :
  • --browser
  • --workspace
  • -w

Ligne de commande :
npm bugs <package>
Description :

Ouvre la page des bugs d'un package

Options :
  • --browser
  • --workspace
  • -w

Ligne de commande :
npm config
Description :

Gère la configuration npm

Options :
  • set
  • get
  • delete
  • list
  • edit
  • --global
  • -g
  • --location

Ligne de commande :
npm config list
Description :

Liste la configuration npm

Options :
  • -g
  • --global
  • --json

Ligne de commande :
npm config get registry
Description :

Affiche le registre configuré

Ligne de commande :
npm config set registry https://registry.npmjs.org/
Description :

Définit le registre npm

Options :
  • set

Ligne de commande :
npm config set init-author-name "John Doe"
Description :

Définit l'auteur par défaut

Options :
  • set

Ligne de commande :
npm config set init-license MIT
Description :

Définit la licence par défaut

Options :
  • set

Ligne de commande :
npm config set save-exact true
Description :

Active les versions exactes par défaut

Options :
  • set

Ligne de commande :
npm config delete registry
Description :

Supprime une configuration

Options :
  • delete

Ligne de commande :
npm config edit
Description :

Ouvre le fichier de configuration dans l'éditeur

Options :
  • -g
  • --global

Ligne de commande :
npm login
Description :

Se connecte au registre npm

Options :
  • --registry
  • --scope
  • --auth-type
  • --auth-type=web
  • --auth-type=legacy

Ligne de commande :
npm adduser
Description :

Alias de npm login

Options :
  • --registry
  • --scope

Ligne de commande :
npm logout
Description :

Se déconnecte du registre npm

Options :
  • --registry
  • --scope

Ligne de commande :
npm whoami
Description :

Affiche l'utilisateur npm connecté

Options :
  • --registry

Ligne de commande :
npm token
Description :

Gère les tokens d'authentification

Options :
  • list
  • create
  • revoke
  • --read-only
  • --cidr

Ligne de commande :
npm token list
Description :

Liste les tokens actifs

Options :
  • --registry

Ligne de commande :
npm token create --read-only
Description :

Crée un token en lecture seule

Options :
  • --read-only
  • --cidr

Ligne de commande :
npm token revoke <token_id>
Description :

Révoque un token

Ligne de commande :
npm access
Description :

Gère les accès des packages publiés

Options :
  • public
  • restricted
  • grant
  • revoke
  • ls-packages
  • ls-collaborators
  • edit

Ligne de commande :
npm access public <package>
Description :

Rend un package scopé public

Ligne de commande :
npm access grant <user> <package>
Description :

Donne accès à un utilisateur

Ligne de commande :
npm access ls-packages
Description :

Liste les packages accessibles

Options :
  • --user
  • --registry

Ligne de commande :
npm owner
Description :

Gère les propriétaires d'un package

Options :
  • add
  • rm
  • ls

Ligne de commande :
npm owner add <user> <package>
Description :

Ajoute un propriétaire

Options :
  • --registry

Ligne de commande :
npm owner rm <user> <package>
Description :

Retire un propriétaire

Ligne de commande :
npm owner ls <package>
Description :

Liste les propriétaires

Ligne de commande :
npm team
Description :

Gère les équipes npm

Options :
  • create
  • destroy
  • add
  • rm
  • ls

Ligne de commande :
npm team create <scope:team>
Description :

Crée une équipe

Options :
  • --registry

Ligne de commande :
npm team add <scope:team> <user>
Description :

Ajoute un utilisateur à une équipe

Ligne de commande :
npm pack
Description :

Crée un tarball du package (pour test local)

Options :
  • --dry-run
  • --json
  • --pack-destination

Ligne de commande :
npm pack --pack-destination ./local-packages
Description :

Crée le tarball dans un dossier spécifique

Options :
  • --pack-destination

Ligne de commande :
npm prefix
Description :

Affiche le préfixe d'installation

Options :
  • --global
  • -g

Ligne de commande :
npm root
Description :

Affiche le chemin de node_modules

Options :
  • --global
  • -g

Ligne de commande :
npm bin
Description :

Affiche le dossier des exécutables npm

Options :
  • --global
  • -g

Ligne de commande :
npm explore <package>
Description :

Explore un package installé (ouvre un shell)

Options :
  • --

Ligne de commande :
npm explore express -- ls
Description :

Exécute ls dans le dossier d'Express

Options :
  • --

Ligne de commande :
npm exec
Description :

Exécute une commande depuis un package npm

Options :
  • --workspace
  • -w
  • --workspaces
  • --include-workspace-root
  • -c
  • --call
  • --yes
  • -y
  • --no
  • -n
  • --package
  • -p

Ligne de commande :
npm exec -- cowsay "Hello"
Description :

Exécute cowsay sans l'installer

Options :
  • --
  • --yes
  • -y

Ligne de commande :
npm exec -c "tsc --version"
Description :

Exécute une commande avec -c

Options :
  • -c
  • --call

Ligne de commande :
npx <commande>
Description :

Exécute une commande npm (ancien nom, alias de npm exec)

Options :
  • --package
  • -p
  • --cache
  • --userconfig
  • --call
  • -c
  • --shell
  • --yes
  • -y
  • --no
  • -n
  • --quiet
  • -q
  • --ignore-existing
  • --node-arg
  • -n

Ligne de commande :
npx create-react-app my-app
Description :

Crée une app React avec create-react-app

Ligne de commande :
npx eslint --init
Description :

Initialise ESLint

Ligne de commande :
npx --yes cowsay Hello
Description :

Exécute sans confirmation

Options :
  • -y
  • --yes

Ligne de commande :
npm diff
Description :

Affiche les différences de registre entre packages

Options :
  • --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

Ligne de commande :
npm diff express@4.17.1 express@4.18.2
Description :

Compare deux versions d'Express

Options :
  • --diff

Ligne de commande :
npm find-dupes
Description :

Trouve les dépendances dupliquées

Options :
  • --global
  • -g

Ligne de commande :
npm explain <package>
Description :

Explique pourquoi un package est installé

Options :
  • --global
  • -g

Ligne de commande :
npm why <package>
Description :

Alias de npm explain

Options :
  • -g