npx et npm coexistent dans chaque installation Node.js, mais leurs rôles ne se recouvrent pas autant qu’on pourrait le croire. npm gère le cycle de vie des paquets : installation, mise à jour, suppression, publication. npx se concentre sur l’exécution de binaires, qu’ils soient déjà présents dans le projet ou récupérés à la volée depuis le registre. Cette distinction, simple en apparence, devient plus complexe dès que l’on travaille en équipe ou que l’on configure un pipeline CI.
Ce que npx fait réellement sous le capot depuis npm 7
Depuis npm 7, npx n’est plus un outil autonome : il s’appuie sur npm exec comme couche d’exécution. La commande npx que vous tapez est en réalité une interface vers npm exec, avec quelques différences de syntaxe à connaître.
La plus piégeuse concerne le placement des options. Avec npx, les options doivent être placées avant les arguments du programme. Avec npm exec, le séparateur -- permet de distinguer clairement les options transmises à npm de celles transmises au programme exécuté. Cette nuance génère des comportements inattendus quand on mélange les deux styles dans un même projet.
Le second point qui retient l’attention : si le paquet demandé n’est pas installé localement, npm peut le récupérer dans son cache et l’ajouter au PATH de la commande. En usage interactif, une confirmation est demandée. L’option --yes la supprime, ce qui pose une question de sécurité dans les scripts automatisés.
npm install vs npx : reproducibilité des scripts Node.js en équipe et en CI
C’est ici que le choix entre les deux outils devient structurant. Quand un développeur lance npx create-react-app mon-app depuis son poste, il obtient la version la plus récente du paquet au moment de l’exécution. Un collègue qui répète la commande trois semaines plus tard peut obtenir une version différente, sans aucun avertissement.
Pour les scripts qui doivent produire le même résultat sur tous les postes et dans la CI, inscrire la dépendance dans le package.json est plus fiable que npx. La version est alors fixée dans package.json (et verrouillée dans le lockfile), et le binaire est invoqué via un script npm, par exemple npm run lint.
npx convient mieux à deux cas précis :
- Les outils ponctuels que vous ne souhaitez pas installer durablement dans le projet, comme un générateur de scaffolding utilisé une seule fois pour initialiser l’application.
- Les vérifications rapides d’une version précise d’un outil, en passant explicitement le tag de version avec la syntaxe
npx outil@version.
Pour tout ce qui entre dans le workflow quotidien de l’équipe (lint, tests, build, formatage), une dépendance de développement locale avec un script défini dans package.json garantit une meilleure cohérence.

Le cache npx : disponibilité hors ligne et limites
Quand npx télécharge un paquet pour l’exécuter, il passe par le cache npm. Ce mécanisme permet des exécutions plus rapides lors des appels suivants, mais son comportement en mode hors ligne mérite d’être compris avant de s’en remettre à lui en CI.
npm propose deux niveaux de tolérance au hors ligne. Le mode --offline strict : la commande échoue si les données nécessaires ne sont pas déjà en cache. Le mode --prefer-offline est moins contraignant : il évite les vérifications de fraîcheur, mais peut encore contacter le registre si des données manquent. Dans un pipeline CI sans accès Internet contrôlé, compter sur le cache npx sans le configurer explicitement est un pari risqué.
Il faut également éviter de confondre npm cache clean avec une gestion du cache utilisé par npx. Le cache n’est pas un stockage durable sur lequel on peut s’appuyer de façon pérenne : c’est un mécanisme de réutilisation qui peut être purgé à tout moment.
Quand npm run scripts suffit largement
La section scripts du package.json donne accès aux binaires installés localement sans passer par npx. Quand vous écrivez "lint": "eslint src/" dans vos scripts et que vous invoquez npm run lint, npm résout automatiquement le binaire eslint depuis node_modules/.bin. Pas besoin de npx, pas de téléchargement conditionnel, pas d’ambiguïté de version.
Ce mécanisme couvre la majorité des besoins courants d’un projet Node.js : compilation TypeScript, tests Jest, formatage Prettier, bundling. Les scripts npm partagent le contexte d’exécution du projet, les variables d’environnement définies dans le script, et restent lisibles pour toute l’équipe dans un seul fichier.
L’avantage de npx apparaît surtout en dehors du contexte d’un projet installé, par exemple pour scaffolding initial avec npx create-next-app ou pour tester un outil CLI sans polluer les dépendances d’un projet existant.
Tableau de décision : npm, npx ou npm run
| Situation | Outil recommandé |
|---|---|
| Installer une dépendance dans le projet | npm install |
| Lancer un script défini dans package.json | npm run |
| Générer un projet depuis zéro (scaffolding) | npx |
| Tester une version précise d’un CLI en one-shot | npx outil@version |
| Scripts reproductibles en équipe et en CI | Dépendance locale + npm run |
| Exécution hors ligne garantie | Dépendance locale (cache non fiable) |
La vraie question n’est pas npx contre npm, mais quel niveau de contrôle sur la version et la reproductibilité est nécessaire pour chaque script. Les outils ponctuels et le scaffolding sont le territoire naturel de npx. Tout ce qui s’exécute en CI ou qui implique plusieurs développeurs gagne à passer par des dépendances inscrites et verrouillées.


