Frontend · Backend
npm — commandes essentielles
Les commandes npm essentielles pour initialiser un projet, gérer les dépendances, scripts, versions, workspaces, audits, cache et publication de packages.
147commandesMis à jour le25 août 2026NiveauDébutant
Aucune commande ne correspond à ce choix et à votre recherche.
Premiers pas
6 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm --version | Affiche la version de npm actuellement installée sur la machine. | npm --version | Sûr |
npm version | Affiche les versions de npm, Node.js et de plusieurs composants utilisés par l'environnement courant. | npm version | Sûr |
npm help | Affiche l'aide générale de npm. | npm help | Sûr |
npm help <commande> | Affiche la documentation d'une commande npm précise. | npm help install | Sûr |
npm <commande> --help | Affiche une aide rapide et les options disponibles pour une commande. | npm install --help | Sûr |
npm doctor | Vérifie plusieurs éléments de l'environnement npm afin de détecter des problèmes de configuration, permissions, cache ou registre. | npm doctor | Sûr |
Initialisation
7 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm init | Crée un fichier package.json de manière interactive en demandant les principales informations du projet. | npm init | Sûr |
npm init -y | Crée rapidement un package.json en acceptant les valeurs par défaut. | npm init -y | Sûr |
npm init <initializer> | Lance un package d'initialisation compatible avec npm, par exemple un générateur de projet. | npm init vite@latest | Sûr |
npm create | Alias pratique pour npm init lorsqu'on utilise un package create-*. | npm create vite@latest | Sûr |
npm pkg get | Lit une ou plusieurs propriétés du fichier package.json. | npm pkg get name version | Sûr |
npm pkg set | Modifie ou ajoute une propriété dans package.json depuis la ligne de commande. | npm pkg set type=module | Attention |
npm pkg delete | Supprime une propriété de package.json. | npm pkg delete scripts.old | Attention |
Installation
12 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm install | Installe les dépendances déclarées dans package.json et met à jour l'installation locale selon package-lock.json. | npm install | Sûr |
npm i | Alias court de npm install. | npm i | Sûr |
npm install <package> | Installe un package et l'ajoute aux dépendances du projet. | npm install express | Sûr |
npm install <package>@<version> | Installe explicitement une version précise d'un package. | npm install express@5.1.0 | Sûr |
npm install <package>@latest | Installe la version associée au tag latest du package. | npm install typescript@latest | Sûr |
npm install -D | Installe un package dans devDependencies, adapté aux outils nécessaires uniquement au développement. | npm install -D eslint | Sûr |
npm install --save-dev | Forme longue de -D permettant d'ajouter un package dans devDependencies. | npm install --save-dev vitest | Sûr |
npm install -O | Installe un package dans optionalDependencies. | npm install -O fsevents | Sûr |
npm install --save-exact | Enregistre une version exacte dans package.json au lieu d'une plage SemVer. | npm install --save-exact lodash@4.17.21 | Sûr |
npm install --no-save | Installe temporairement un package sans l'ajouter à package.json. | npm install --no-save dotenv | Attention |
npm install --ignore-scripts | Installe les dépendances sans exécuter les scripts lifecycle des packages. Peut être utile lors d'une analyse de sécurité. | npm install --ignore-scripts | Sûr |
npm install --omit=dev | Installe l'arbre de production en omettant les devDependencies du dossier node_modules. | npm install --omit=dev | Sûr |
Installation CI
5 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm ci | Effectue une installation propre et reproductible à partir du package-lock.json. Le lockfile doit être cohérent avec package.json. | npm ci | Attention |
npm ci --omit=dev | Effectue une installation reproductible en omettant les dépendances de développement de node_modules. | npm ci --omit=dev | Sûr |
npm ci --ignore-scripts | Effectue une installation propre sans exécuter les scripts d'installation des dépendances. | npm ci --ignore-scripts | Sûr |
npm ci --workspace | Cible un workspace particulier lors d'une installation dans un projet utilisant les workspaces. | npm ci --workspace=@mon-app/api | Sûr |
npm ci --workspaces | Active l'installation dans le contexte des workspaces déclarés par le projet. | npm ci --workspaces | Sûr |
Suppression
5 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm uninstall | Supprime un package de node_modules et de la section correspondante de package.json. | npm uninstall express | Attention |
npm remove | Alias de npm uninstall. | npm remove lodash | Attention |
npm uninstall -D | Supprime une dépendance de développement. | npm uninstall -D eslint | Attention |
npm prune | Supprime de node_modules les packages qui ne sont plus nécessaires selon package.json. | npm prune | Attention |
npm prune --omit=dev | Supprime les dépendances de développement de l'installation locale lorsque cela correspond au besoin de production. | npm prune --omit=dev | Attention |
Inspection
9 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm list | Affiche l'arbre des dépendances installées pour le projet courant. | npm list | Sûr |
npm list --depth=0 | Affiche uniquement les dépendances de premier niveau. | npm list --depth=0 | Sûr |
npm list <package> | Indique où une dépendance précise apparaît dans l'arbre local. | npm list lodash | Sûr |
npm explain | Explique pourquoi un package est présent dans node_modules et quelle dépendance l'a introduit. | npm explain lodash | Sûr |
npm view | Affiche les métadonnées publiées d'un package dans le registre npm. | npm view express | Sûr |
npm view <package> version | Affiche la version actuellement associée au tag par défaut du package. | npm view express version | Sûr |
npm view <package> versions | Affiche les versions publiées d'un package. | npm view express versions --json | Sûr |
npm view <package> dependencies | Affiche les dépendances déclarées par un package publié. | npm view express dependencies | Sûr |
npm root | Affiche le chemin du dossier node_modules local. | npm root | Sûr |
Mises à jour
6 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm outdated | Compare les versions installées, demandées et disponibles des dépendances. | npm outdated | Sûr |
npm update | Met à jour les packages installés en respectant les plages de versions déclarées. | npm update | Attention |
npm update <package> | Met à jour une dépendance particulière dans les limites autorisées par la configuration du projet. | npm update express | Attention |
npm install <package>@latest | Met explicitement une dépendance au tag latest et modifie généralement package.json. | npm install react@latest | Attention |
npm dedupe | Essaie de réduire les duplications dans l'arbre node_modules en déplaçant des dépendances compatibles plus haut dans l'arbre. | npm dedupe | Sûr |
npm dedupe --dry-run | Prévisualise les changements que npm dedupe effectuerait sans modifier l'installation. | npm dedupe --dry-run | Sûr |
package-lock.json
3 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm install --package-lock-only | Met à jour package-lock.json sans installer réellement les dépendances dans node_modules. | npm install --package-lock-only | Attention |
npm ci | Utilise package-lock.json comme référence stricte et refuse de modifier le lockfile. | npm ci | Sûr |
npm shrinkwrap | Renomme ou génère un npm-shrinkwrap.json destiné notamment aux packages publiés qui souhaitent verrouiller leur arbre. | npm shrinkwrap | Attention |
Scripts
8 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm run | Affiche les scripts disponibles dans la section scripts de package.json. | npm run | Sûr |
npm run <script> | Exécute un script défini dans package.json. | npm run build | Sûr |
npm start | Exécute le script start du projet. | npm start | Sûr |
npm test | Exécute le script test du projet. | npm test | Sûr |
npm stop | Exécute le script stop s'il est défini. | npm stop | Sûr |
npm restart | Exécute la logique de redémarrage prévue par npm et les scripts associés. | npm restart | Sûr |
npm run <script> -- <args> | Transmet des arguments supplémentaires au programme exécuté par un script npm. | npm run test -- --watch | Sûr |
npm run --silent | Réduit les messages générés par npm pour mettre davantage en avant la sortie du script. | npm run --silent build | Sûr |
Exécution de packages
5 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm exec | Exécute une commande provenant d'un package local ou téléchargé selon la résolution effectuée par npm. | npm exec eslint . | Sûr |
npm exec --package | Indique explicitement le package à rendre disponible pour la commande exécutée. | npm exec --package=typescript -- tsc --version | Sûr |
npm exec --yes | Autorise npm à continuer sans demander certaines confirmations interactives lors de l'installation temporaire requise. | npm exec --yes cowsay "Bonjour" | Attention |
npx | Commande couramment utilisée pour exécuter un binaire fourni par un package. Dans les versions modernes de npm, son comportement repose sur npm exec. | npx eslint . | Sûr |
npx <package>@<version> | Exécute explicitement une version particulière d'un outil. | npx typescript@latest --version | Attention |
Sécurité
9 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm audit | Analyse l'arbre des dépendances par rapport aux vulnérabilités connues rapportées par le registre configuré. | npm audit | Sûr |
npm audit --json | Retourne le rapport d'audit dans un format JSON exploitable par des outils ou pipelines. | npm audit --json | Sûr |
npm audit --audit-level=high | Configure le niveau minimal de vulnérabilité qui provoque un code de sortie non nul. | npm audit --audit-level=high | Sûr |
npm audit fix | Essaie d'appliquer automatiquement des changements compatibles afin de corriger des vulnérabilités. | npm audit fix | Attention |
npm audit fix --force | Autorise des corrections qui dépassent les protections habituelles de npm et peuvent introduire des changements majeurs incompatibles. | npm audit fix --force | Danger |
npm audit signatures | Vérifie les signatures de registre et les attestations de provenance disponibles pour les packages. | npm audit signatures | Sûr |
npm approve-scripts | Permet d'approuver explicitement certains scripts d'installation de dépendances dans les versions npm qui prennent en charge cette politique. | npm approve-scripts | Attention |
npm deny-scripts | Permet de refuser explicitement l'exécution des scripts d'installation de dépendances sélectionnées. | npm deny-scripts | Sûr |
npm install --ignore-scripts | Empêche l'exécution des scripts lifecycle lors de l'installation. Utile pour inspecter un projet non fiable avant d'autoriser du code. | npm install --ignore-scripts | Sûr |
Cache
3 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm cache verify | Vérifie l'intégrité du cache npm et effectue sa maintenance. | npm cache verify | Sûr |
npm cache clean --force | Vide le cache npm. npm protège volontairement cette action derrière --force car elle est rarement nécessaire. | npm cache clean --force | Attention |
npm cache add | Ajoute explicitement un package ou une ressource au cache npm. | npm cache add lodash | Sûr |
Configuration
7 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm config list | Affiche la configuration npm actuellement résolue. | npm config list | Sûr |
npm config list --long | Affiche la configuration complète avec davantage de valeurs par défaut. | npm config list --long | Sûr |
npm config get | Lit une valeur de configuration particulière. | npm config get registry | Sûr |
npm config set | Modifie une valeur de configuration npm. | npm config set save-exact true | Attention |
npm config delete | Supprime une valeur de configuration personnalisée. | npm config delete save-exact | Attention |
npm config set --location=project | Enregistre une configuration au niveau du projet, généralement dans un fichier .npmrc local. | npm config set legacy-peer-deps=true --location=project | Attention |
npm config get registry | Affiche l'URL du registre npm actuellement configuré. | npm config get registry | Sûr |
Registry
6 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm ping | Teste la connexion et l'authentification auprès du registre npm configuré. | npm ping | Sûr |
npm login | Authentifie l'utilisateur auprès du registre configuré. | npm login | Sûr |
npm logout | Déconnecte l'utilisateur du registre npm. | npm logout | Sûr |
npm whoami | Affiche l'utilisateur actuellement authentifié auprès du registre. | npm whoami | Sûr |
npm profile get | Affiche les informations disponibles du profil npm connecté. | npm profile get | Sûr |
npm token list | Liste les informations disponibles sur les tokens associés au compte lorsque la commande et les permissions le permettent. | npm token list | Sûr |
Recherche packages
6 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm search | Recherche des packages dans le registre npm. | npm search markdown parser | Sûr |
npm view | Consulte les métadonnées d'un package sans l'installer. | npm view vite | Sûr |
npm docs | Ouvre la documentation ou la page associée au package. | npm docs express | Sûr |
npm repo | Ouvre le dépôt source déclaré par le package. | npm repo express | Sûr |
npm bugs | Ouvre la page de suivi des bugs déclarée par le package. | npm bugs express | Sûr |
npm home | Ouvre la page d'accueil déclarée par le package. | npm home express | Sûr |
Versions & SemVer
6 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm version | Affiche les versions de l'environnement ou permet, avec un argument, de modifier la version du package courant. | npm version | Sûr |
npm version patch | Incrémente la partie patch de la version, par exemple 1.2.3 vers 1.2.4. | npm version patch | Attention |
npm version minor | Incrémente la version mineure, par exemple 1.2.3 vers 1.3.0. | npm version minor | Attention |
npm version major | Incrémente la version majeure, par exemple 1.2.3 vers 2.0.0. | npm version major | Attention |
npm version prerelease | Incrémente ou crée une version de prépublication. | npm version prerelease --preid=beta | Attention |
npm version --no-git-tag-version | Met à jour la version des fichiers package sans créer automatiquement de commit ou tag Git associé. | npm version patch --no-git-tag-version | Attention |
Workspaces
8 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm init -w | Initialise un nouveau package dans un workspace et l'intègre au projet utilisant les workspaces. | npm init -w packages/api | Sûr |
npm install -w | Installe une dépendance uniquement dans un workspace sélectionné. | npm install express -w packages/api | Sûr |
npm uninstall -w | Supprime une dépendance dans un workspace précis. | npm uninstall express -w packages/api | Attention |
npm run -w | Exécute un script dans un workspace particulier. | npm run build -w packages/api | Sûr |
npm run --workspaces | Exécute un script dans l'ensemble des workspaces concernés. | npm run test --workspaces | Sûr |
npm exec -w | Exécute une commande dans le contexte d'un workspace. | npm exec -w packages/api -- eslint . | Sûr |
npm publish --workspace | Publie un workspace particulier vers le registre. | npm publish --workspace=@mon-org/api | Danger |
npm publish --workspaces | Publie les workspaces concernés. Cette opération peut publier plusieurs packages. | npm publish --workspaces | Danger |
Packages locaux
5 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm link | Crée des liens symboliques permettant de développer un package local tout en l'utilisant dans un autre projet. | npm link | Attention |
npm link <package> | Relie un package précédemment enregistré globalement avec npm link au projet courant. | npm link mon-package | Attention |
npm install ../package | Installe un package à partir d'un chemin local. | npm install ../mon-package | Sûr |
npm pack | Crée l'archive .tgz qui serait utilisée pour publier ou distribuer le package. | npm pack | Sûr |
npm pack --dry-run | Prévisualise le contenu du package qui serait empaqueté sans produire réellement l'archive finale. | npm pack --dry-run | Sûr |
Publication
7 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm publish --dry-run | Prévisualise les fichiers et informations qui seraient utilisés pour publier le package sans effectuer la publication. | npm publish --dry-run | Sûr |
npm publish | Publie le package courant vers le registre configuré. Une version publiée ne doit pas être considérée comme une opération anodine. | npm publish | Danger |
npm publish --access public | Publie explicitement un package avec un niveau d'accès public. | npm publish --access public | Danger |
npm publish --tag | Publie une version sous un dist-tag particulier comme beta ou next. | npm publish --tag beta | Danger |
npm publish --provenance | Publie avec des informations de provenance lorsque l'environnement CI/CD utilisé est pris en charge par npm. | npm publish --provenance | Danger |
npm unpublish | Retire une publication lorsque les règles du registre l'autorisent. Cette opération peut casser des consommateurs et est fortement encadrée. | npm unpublish mon-package@1.0.0 | Danger |
npm deprecate | Marque une version ou plage de versions comme dépréciée et affiche un avertissement aux utilisateurs qui l'installent. | npm deprecate mon-package@"<2.0.0" "Utilisez la version 2" | Attention |
Dist-tags
3 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm dist-tag ls | Affiche les tags de distribution associés à un package. | npm dist-tag ls mon-package | Sûr |
npm dist-tag add | Associe un tag de distribution à une version publiée. | npm dist-tag add mon-package@2.0.0-beta.1 beta | Attention |
npm dist-tag rm | Supprime un dist-tag d'un package publié. | npm dist-tag rm mon-package beta | Attention |
Accès packages
4 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm access | Gère les paramètres d'accès de packages publiés lorsque l'utilisateur possède les permissions nécessaires. | npm access list packages | Sûr |
npm owner ls | Affiche les propriétaires actuellement associés à un package. | npm owner ls mon-package | Sûr |
npm owner add | Ajoute un propriétaire à un package publié. | npm owner add alice mon-package | Danger |
npm owner rm | Retire un propriétaire d'un package. Peut modifier fortement la capacité d'administration du package. | npm owner rm alice mon-package | Danger |
Différences
2 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm diff | Compare le contenu du package local à celui résolu depuis le registre selon les paramètres de la commande. | npm diff | Sûr |
npm diff --diff | Compare des versions ou spécifications de package particulières. | npm diff --diff=express@4 --diff=express@5 | Sûr |
Financement
2 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm fund | Affiche les dépendances du projet qui déclarent des informations de financement. | npm fund | Sûr |
npm fund <package> | Ouvre ou affiche les informations de financement associées à un package. | npm fund eslint | Sûr |
Diagnostic
7 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm doctor | Effectue plusieurs vérifications de santé de l'environnement npm. | npm doctor | Sûr |
npm config get registry | Vérifie que npm utilise le registre attendu. | npm config get registry | Sûr |
npm ping | Vérifie la connectivité avec le registre configuré. | npm ping | Sûr |
npm cache verify | Vérifie l'intégrité du cache lorsque des téléchargements ou installations semblent incohérents. | npm cache verify | Sûr |
npm list | Aide à repérer des dépendances invalides, absentes ou dupliquées. | npm list | Sûr |
npm explain | Permet de comprendre pourquoi une dépendance problématique est installée. | npm explain minimist | Sûr |
npm outdated | Permet d'identifier rapidement les dépendances qui ont pris du retard. | npm outdated | Sûr |
À manipuler avec prudence
6 commandes| Commande | Description | Exemple | Risque |
|---|---|---|---|
npm audit fix --force | Autorise npm à appliquer des changements qui peuvent sortir des plages de versions prévues et introduire des incompatibilités majeures. | npm audit fix --force | Danger |
npm publish | Publie réellement une version sur le registre npm. Vérifier nom, version, contenu, secrets et visibilité avant exécution. | npm publish | Danger |
npm unpublish | Retire une version du registre lorsque la politique npm le permet et peut casser les projets qui en dépendent. | npm unpublish mon-package@1.0.0 | Danger |
npm owner rm | Retire les droits d'un propriétaire sur un package publié. | npm owner rm alice mon-package | Danger |
npm cache clean --force | Vide volontairement le cache npm. Cette opération est rarement nécessaire et doit suivre un diagnostic. | npm cache clean --force | Attention |
npm exec package inconnu | Exécuter un package inconnu peut lancer du code récupéré depuis le registre. Toujours vérifier le package et sa provenance avant de confirmer. | npm exec --package=package-verifie -- commande | Danger |