Aller au contenu
Runbook

Installer Node.js sur Windows

Runtime JavaScript côté serveur, fondé sur le moteur V8, livré avec le gestionnaire de paquets npm.

Runtimejavascriptruntimebackendv8npm

Installation

winget (dernière LTS) · winget
winget install OpenJS.NodeJS.LTS

Installe la dernière version LTS officielle avec npm. Redémarrez le terminal après l'installation pour rafraîchir le PATH.

Vérifier l'installation

Vérifier
node --version

Fichiers importants

TypeCheminDescription
config%USERPROFILE%\.npmrcConfiguration utilisateur de npm (registre, proxy, jetons d'authentification).
binaireC:\Program Files\nodejs\node.exeExécutable du runtime installé par le programme d'installation officiel.

Outils en ligne de commande

  • nodeLe runtime JavaScript.
  • npmGestionnaire de paquets Node.js.
  • npxExécute un binaire d'un paquet sans l'installer globalement.
  • corepackActive et gère pnpm et yarn.

Désinstaller

Désinstaller (winget)
winget uninstall OpenJS.NodeJS.LTS

À savoir

  • Pour gérer plusieurs versions sous Windows, utilisez fnm ou nvm-windows (projet distinct du nvm Unix).
  • Activez pnpm et yarn via Corepack avec "corepack enable".
  • Corepack est livré avec Node jusqu'à la version 24 ; à partir de Node 25 il n'est plus inclus et doit être installé séparément (par exemple "npm install --global corepack"). Vérifiez ce que fournit la LTS que vous installez.
  • Après l'installation, ouvrez un nouveau terminal (PowerShell ou cmd) pour que la variable PATH soit prise en compte.

Installation sur Windows

Le gestionnaire de paquets winget, intégré aux versions récentes de Windows, installe la dernière LTS officielle avec winget install OpenJS.NodeJS.LTS. Cette commande utilise le programme d'installation MSI officiel, qui place les binaires dans C:\Program Files\nodejs et les ajoute au PATH. Ouvrez un nouveau terminal après l'installation pour que node et npm soient reconnus.

Gérer plusieurs versions

Le nvm classique d'Unix ne fonctionne pas sous Windows. Utilisez à la place fnm (multi-plateforme, recommandé) ou nvm-windows, un projet distinct. Ces outils permettent de basculer entre versions de Node.js par projet sans réinstaller le MSI.

Configuration

La configuration utilisateur de npm est stockée dans %USERPROFILE%\.npmrc. Pour utiliser pnpm ou yarn sans installation distincte, activez Corepack avec corepack enable. Corepack est livré avec Node jusqu'à la version 24 ; à partir de Node 25 il n'est plus inclus et doit être installé séparément (par exemple avec npm install --global corepack), vérifiez donc ce que fournit la LTS que vous visez.

Si vous compilez des modules natifs, installez les Visual Studio Build Tools en sélectionnant la charge de travail « Desktop development with C++ », ainsi que Python : node-gyp les détecte automatiquement lors de la compilation. L'installeur officiel et winget peuvent proposer ces dépendances pendant l'installation de Node.js. N'utilisez plus le paquet windows-build-tools : il est archivé depuis 2021 et ne fonctionne pas avec les versions récentes de Node.