Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
Node.js

Comment installer Node.js sur Windows

Cette leçon guide l'installation de Node.js sur Windows avec l'installateur officiel : versions compatibles, choix d'une version LTS et du bon fichier (.msi 64 bits) ou de winget, rôle de chaque optio...

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

Cette leçon guide l'installation de Node.js sur Windows avec l'installateur officiel : versions compatibles, choix d'une version LTS et du bon fichier (.msi 64 bits) ou de winget, rôle de chaque option de l'installateur (runtime, npm, Add to PATH, outils pour modules natifs), vérification avec node, npm et npx, emplacement des fichiers et des outils globaux, mise à jour de npm et désinstallation. Un tableau de dépannage traite les erreurs les plus courantes (commande non reconnue, PowerShell, droits, proxy), avec deux activités corrigées et un quiz.
  1. Objectifs

    • Choisir la bonne version de Node.js et le bon fichier d'installation.
    • Installer Node.js sur Windows avec l'installateur officiel, en comprenant chaque option.
    • Vérifier l'installation et savoir où Node.js et npm sont installés.
    • Mettre à jour npm, désinstaller Node.js et résoudre les problèmes les plus courants.
  2. Présentation

    • Node.js est un environnement d'exécution JavaScript : il permet d'exécuter du code JavaScript en dehors des navigateurs, par exemple sur un serveur.
    • Open source et multiplateforme, il permet de construire une application web complète avec un seul langage, côté navigateur comme côté serveur.
    • Dans cette leçon, vous installez Node.js sur Windows avec l'installateur officiel. C'est la méthode la plus simple pour débuter. Pour installer plusieurs versions côte à côte, vous utiliserez plutôt un gestionnaire de versions, présenté dans la leçon suivante.
  3. Compatibilité

    • Les versions actuelles de Node.js fonctionnent sous :
      • Windows 10 et Windows 11 sur PC, en 64 bits (processeurs x64 ou ARM64) ;
      • Windows Server 2016 et les versions plus récentes pour les serveurs.
    • Windows 7, 8 et 8.1 ne sont plus pris en charge, et il n'existe plus de version 32 bits récente. Pour vérifier votre système : Windows + Pause, ou Paramètres → Système → Informations système.
  4. Étapes d'installation

    • Le schéma suivant résume les cinq étapes. Elles sont détaillées ensuite.
    • Les 5 étapes de l'installation de Node.js sur Windows
    1. Téléchargez le programme d'installation (.msi)
      • Rendez-vous sur la page Téléchargements du site officiel nodejs.org.
      • Choisissez une version LTS (Long Term Support) : c'est la version stable, recommandée pour les projets et pour ce cours. Les versions marquées Current contiennent les dernières nouveautés, mais sont moins éprouvées (voir la leçon Histoire de Node.js).
      • Sélectionnez le système Windows, l'architecture x64 (ou ARM64 pour certains PC portables récents) et le format Windows Installer (.msi).
      • Variante en ligne de commande : Windows 10 et 11 proposent le gestionnaire d'applications winget. Dans un terminal, winget install OpenJS.NodeJS.LTS installe la dernière version LTS sans passer par le navigateur.
    2. Exécutez le programme d'installation
      • Lancez le fichier téléchargé, par exemple node-v24.22.1-x64.msi. Cliquez sur Next, acceptez la licence, puis gardez le dossier proposé : C:\Program Files\nodejs\.
      • L'écran Custom Setup présente les fonctionnalités à installer. Gardez-les toutes (leur rôle est détaillé dans la section suivante). La capture ci-dessous provient d'une version précédente ; les écrans actuels sont presque identiques.
      • Écran Custom Setup de l'installateur de Node.js

    3. Les outils pour les modules natifs (facultatif)
      • L'écran suivant propose une case « Automatically install the necessary tools » (Tools for Native Modules).
      • Option Tools for Native Modules de l'installateur de Node.js

      • Certains rares paquets npm contiennent du code C++ à compiler sur votre machine ; ils ont besoin de Python et des outils de compilation de Visual Studio. Cocher la case installe ces outils (avec Chocolatey). Cela représente plusieurs gigaoctets et un long temps d'installation.
      • Pour ce cours, laissez la case décochée: aucun des paquets utilisés (Express, Mongoose, bcrypt…) ne l'exige sur une installation récente. Vous pourrez toujours installer ces outils plus tard si un paquet le demande.
    4. Finalisez l'installation
      • Cliquez sur Install, acceptez la demande d'autorisation de Windows, puis sur Finish. Node.js et npm sont installés.
      • Important: fermez les terminaux déjà ouverts (y compris celui de Visual Studio Code) et ouvrez-en un nouveau. Un terminal ouvert avant l'installation ne connaît pas encore la commande node.
  5. Les fonctionnalités proposées par l'installateur

    • Voici le rôle de chaque fonctionnalité de l'écran Custom Setup:
    • FonctionnalitéRôleConseil
      Node.js runtimeLe cœur de Node.js : le programme node.exe qui exécute le JavaScriptobligatoire
      corepack managerOutil qui gère les gestionnaires de paquets Yarn et pnpm. Présent jusqu'à Node.js 24 ; il n'est plus livré avec Node.js à partir de la version 25laisser par défaut
      npm package managerLe gestionnaire de paquets officiel, pour installer Express, Mongoose…indispensable
      Online documentation shortcutsRaccourcis vers la documentation et le site officiel dans le menu Démarrerfacultatif
      Add to PATHAjoute Node.js, npm et les outils installés globalement à la variable d'environnement PATH, pour pouvoir les utiliser dans n'importe quel terminalindispensable
    • Le PATH est la liste des dossiers dans lesquels Windows cherche les programmes quand vous tapez une commande. Si Add to PATH n'est pas installé, la commande node n'est pas trouvée : « 'node' n'est pas reconnu en tant que commande interne ou externe ».
    • En cliquant sur l'icône à côté d'une fonctionnalité, vous pouvez choisir de l'installer (Will be installed on local hard drive), de l'installer avec toutes ses sous-fonctionnalités (Entire feature will be installed…) ou de ne pas l'installer (Entire feature will be unavailable). Le plus simple est de ne rien changer : par défaut, tout est installé.
  6. Vérifier l'installation

    • Dans un nouveau terminal (Invite de commandes, PowerShell ou terminal de VS Code), tapez :
    node -v
    npm -v
    npx -v
  7. Chaque commande doit afficher un numéro de version, par exemple :
  8. C:\Users\sara> node -v
    v24.22.1
    C:\Users\sara> npm -v
    11.6.2
    C:\Users\sara> npx -v
    11.6.2
  9. Vos numéros seront différents selon la date de votre installation : l'important est que les trois commandes répondent. npx est installé avec npm ; il sert à exécuter un outil sans l'installer, par exemple npx @angular/cli new mon-projet.
  10. Dernier test, pour vérifier que Node.js exécute bien du JavaScript :
  11. node -e "console.log('Node.js fonctionne !')"
  12. Où Node.js est-il installé ?

    • La commande where node (Invite de commandes) ou where.exe node (PowerShell) indique l'emplacement du programme. Avec l'installateur, Node.js se trouve dans C:\Program Files\nodejs\:
    • ÉlémentRôle
      node.exeLe programme Node.js. Avec un nom de fichier (node app.js), il exécute ce fichier ; sans argument, il ouvre la console interactive (REPL)
      npm, npm.cmdLe lanceur de npm, le gestionnaire de paquets
      npx, npx.cmdLe lanceur de npx, qui exécute un paquet sans l'installer
      node_modules\Les paquets livrés avec Node.js, à commencer par npm lui-même
    • Les outils que vous installez globalement avec npm install -g ne vont pas dans ce dossier, mais dans votre profil : C:\Users\<vous>\AppData\Roaming\npm. La commande npm config get prefix affiche cet emplacement.
    • Les paquets d'un projet, eux, sont installés dans le dossier node_modules de ce projet (chapitre 4).
  13. Mettre à jour npm

    • Chaque version de Node.js est livrée avec une version précise de npm. npm évolue plus vite que Node.js : une version plus récente est souvent disponible. Pour la mettre à jour :
    npm install -g npm@latest
    npm -v
  14. Si un message d'autorisation apparaît (EPERM), relancez le terminal en tant qu'administrateur.
  15. Pour mettre à jour Node.js lui-même, téléchargez simplement le nouvel installateur LTS et lancez-le : il remplace l'ancienne version, et vos projets ne sont pas touchés.
  16. Désinstaller Node.js et npm

    • On désinstalle Node.js comme la plupart des logiciels Windows :
      1. ouvrez Paramètres → Applications → Applications installées (ou Panneau de configuration → Programmes et fonctionnalités) ;
      2. sélectionnez Node.js, puis cliquez sur Désinstaller.
    • Pour un nettoyage complet, avant d'installer nvm-windows par exemple, supprimez aussi les dossiers %AppData%\npm et %LocalAppData%\npm-cache (tapez ces chemins dans la barre d'adresse de l'Explorateur).
  17. Résoudre les problèmes courants

      Message ou symptômeCause probableSolution
      « 'node' n'est pas reconnu en tant que commande interne ou externe »Le terminal a été ouvert avant l'installation, ou Add to PATH n'a pas été installéOuvrir un nouveau terminal ; sinon relancer l'installateur, choisir Modify et activer Add to PATH
      « l'exécution de scripts est désactivée sur ce système » (PowerShell)Politique de sécurité de PowerShellVoir la leçon Erreur exécution de script sur Visual Studio Code, ou utiliser l'Invite de commandes
      EPERM ou EACCES lors d'un npm install -gDroits insuffisantsTerminal en administrateur
      npm install reste bloqué ou échoue en ETIMEDOUTProxy ou pare-feu (réseau d'entreprise, centre de formation)Configurer le proxy : npm config set proxy http://adresse:port
      node -v affiche une ancienne versionUne ancienne installation est trouvée en premier dans le PATHwhere node pour la repérer, puis désinstaller l'ancienne version
  18. Activité 1 : installer et vérifier

    • Installez Node.js LTS en suivant la leçon, puis complétez cette fiche :
      1. version de Node.js installée : ……… ;
      2. version de npm : ……… ;
      3. emplacement de node.exe (commande where node) : ……… ;
      4. dossier des outils globaux (commande npm config get prefix) : ……… ;
      5. résultat de node -p "process.release.lts": ……… .
    • Voir un exemple de fiche remplie
      C:\Users\sara> node -v
      v24.22.1
      C:\Users\sara> npm -v
      11.6.2
      C:\Users\sara> where node
      C:\Program Files\nodejs\node.exe
      C:\Users\sara> npm config get prefix
      C:\Users\sara\AppData\Roaming\npm
      C:\Users\sara> node -p "process.release.lts"
      Krypton

      La dernière commande affiche le nom de code de la version LTS (Krypton pour Node.js 24) ; elle affiche undefined pour une version Current.

  19. Activité 2 : diagnostiquer une installation

    • Pour chaque situation, indiquez la cause probable et la solution :
      1. Karim vient d'installer Node.js. Dans le terminal de VS Code, ouvert depuis ce matin, node -v répond « 'node' n'est pas reconnu… ».
      2. Leila tape npm install -g nodemon et obtient une erreur EPERM: operation not permitted.
      3. Dans la salle de formation, npm install express reste bloqué plusieurs minutes puis échoue avec ETIMEDOUT, alors que le navigateur fonctionne.
    • Voir le corrigé
      1. Le terminal a été ouvert avant l'installation : il ne connaît pas le nouveau PATH. Fermer VS Code et le rouvrir.
      2. Droits insuffisants pour écrire dans le dossier global : relancer le terminal en tant qu'administrateur.
      3. Le réseau passe par un proxy que le navigateur connaît, mais pas npm : configurer le proxy de npm (npm config set proxy et npm config set https-proxy) avec l'adresse fournie par l'administrateur réseau.
  20. À retenir

    • On installe une version LTS, au format .msi 64 bits, depuis nodejs.org (ou avec winget install OpenJS.NodeJS.LTS).
    • Les fonctionnalités indispensables sont Node.js runtime, npm et Add to PATH; les outils pour modules natifs sont facultatifs.
    • Après l'installation, on ouvre un nouveau terminal et on vérifie avec node -v, npm -v et npx -v.
    • Node.js est installé dans C:\Program Files\nodejs\; les outils globaux vont dans %AppData%\npm.
  21. Testez-vous

    • 1. Pourquoi choisir une version LTS plutôt qu'une version Current ?
    • 2. À quoi sert l'option Add to PATH?
    • 3. Faut-il cocher les outils pour modules natifs pour suivre ce cours ? Pourquoi ?
    • 4. Quelle commande indique où se trouve le programme node?
    • 5. Comment mettre à jour npm sans réinstaller Node.js ?
    • Voir les réponses
      1. Elle est stable et reçoit des correctifs, notamment de sécurité, pendant plusieurs années.
      2. Elle permet d'utiliser node, npm et npx depuis n'importe quel terminal, en ajoutant leur dossier à la variable PATH.
      3. Non : ils ne servent qu'aux rares paquets qui doivent compiler du code C++, et ils occupent plusieurs gigaoctets.
      4. where node (Invite de commandes) ou where.exe node (PowerShell).
      5. npm install -g npm@latest.

Cet article vous a-t-il aidé ?