Installer Node.js sur Windows

Article
12/20/2023

Si vous débutez dans le développement avec Node.js et souhaitez être rapidement opérationnel afin d’apprendre, suivez les étapes ci-dessous pour installer Node.js directement sur Windows.

Note

Si vous utilisez Node.js dans un cadre professionnel, attachez de l’importance à la vitesse des performances et à la compatibilité des appels système, souhaitez exécuter des conteneurs Docker qui tirent parti des espaces de travail Linux et évitent d’avoir à gérer à la fois des scripts de compilation Linux et Windows ou simplement préférez utiliser une ligne de commande Bash, installez Node.js sur le Sous-système Windows pour Linux (plus précisément, WSL 2).

Installer nvm-windows, node.js et npm

En plus de choisir s’il faut procéder à l’installation sur Windows ou WSL, il faut prendre d’autres décisions lors de l’installation de Node.js. Nous vous recommandons d'utiliser un gestionnaire de versions car les versions changent très rapidement. Vous devrez probablement passer d’une version à une autre de Node.js en fonction des besoins des différents projets sur lesquels vous travaillez. Node Version Manager, également appelé nvm, est la méthode la plus couramment utilisée pour installer plusieurs versions de Node.js, mais elle est uniquement disponible sous Mac/Linux ; elle n'est pas prise en charge par Windows. À la place, nous vous recommandons d’installer nvm-windows, puis de l’utiliser pour installer Node.js et le Gestionnaire de package de nœud (npm). D’autres gestionnaires de versions sont également à prendre en compte. Ceux-ci sont couverts à la section suivante.

Important

Veillez à supprimer toutes les installations existantes de Node.js ou de npm de votre système d'exploitation avant d'installer un gestionnaire de versions car les différents types d'installation peuvent entraîner des conflits. Cela inclut la suppression de tous les répertoires d'installation existants de Node.js (par exemple, « C:\Program Files\nodejs ») qui pourraient subsister. Le lien symbolique généré par NVM n'écrasera pas un répertoire d'installation existant (même vide). Pour obtenir de l'aide sur la suppression des installations précédentes, consultez Supprimer complètement node.js de Windows.

Avertissement

NVM est conçu pour être installé par utilisateur et appelé par interpréteur de commandes. Il n’est pas conçu pour les Dev Box partagées ou les serveurs de build avec plusieurs agents de build. NVM fonctionne à l’aide d’un lien symbolique. L’utilisation de nvm dans les scénarios partagés pose problème, car ce lien pointe vers le dossier de données d’application d’un utilisateur. Par conséquent, si l’utilisateur x exécute nvm use lts, le lien pointe le nœud de la Box entière vers son dossier de données d’application. Si l’utilisateur y exécute node ou npm, il est dirigé vers l’exécution des fichiers sous le compte d’utilisateur de x et, dans le cas de npm -g, il modifie les fichiers de x, ce qui n’est pas autorisé par défaut. Par conséquent, nvm est prescrit seulement pour une seule Dev Box. Cela vaut également pour les serveurs de build. Si deux agents de build se trouvent sur la même machine virtuelle/box, ils peuvent entrer en concurrence et entraîner un comportement étrange dans les builds.

Suivez les instructions d’installation dans le dépôt windows-nvm. Nous vous recommandons d’utiliser le programme d’installation, mais si vous avez une compréhension plus approfondie de vos besoins, vous pouvez effectuer une installation manuelle. Le programme d’installation vous indique la page de versions de la version la plus récente.
Téléchargez le fichier nvm-setup.zip de la version la plus récente.
Une fois le fichier zip téléchargé, ouvrez-le, puis ouvrez le fichier nvm-setup.exe.
L'Assistant d'installation Setup-NVM-for-Windows vous guide tout au long du processus d'installation, y compris pour le choix du répertoire dans lequel nvm-windows et Node.js doivent être installés.
Une fois l’installation terminée. Ouvrez PowerShell (il est recommandé de l’ouvrir avec des autorisations d’administrateur élevées) et essayez d’utiliser windows-nvm pour lister les versions de nœud actuellement installées (à ce stade, il ne devrait y en avoir aucune) : nvm ls
Installez la version actuelle de Node.js (pour tester les dernières améliorations apportées aux fonctionnalités, par exemple) : nvm install latest
Installez la dernière version LTS stable de Node.js (recommandé) en recherchant d'abord le numéro de la version LTS actuelle, nvm list available, puis en installant le numéro de la version LTS avec nvm install <version> (en remplaçant <version> par le numéro, à savoir : nvm install 12.14.0).
Répertoriez les versions de Node installées : nvm ls... Les deux versions que vous venez d’installer devraient maintenant être répertoriées.
Après avoir installé les versions de Node.js dont vous avez besoin, sélectionnez celle que vous souhaitez utiliser en entrant nvm use <version> (en remplaçant <version> par le numéro, par exemple : nvm use 12.9.0).
Pour changer la version de Node.js à utiliser pour un projet, créez un nouveau répertoire de projet, mkdir NodeTest, accédez au répertoire, cd NodeTest, puis entrez nvm use <version> en remplaçant <version> par le numéro de la version que vous souhaitez utiliser (à savoir v10.16.3`).
Pour savoir quelle version de npm est installée, entrez : npm --version. Ce numéro de version sera automatiquement remplacé par la version de npm associée à votre version actuelle de Node.js.

Autres gestionnaires de versions

windows-nvm est actuellement le gestionnaire de versions le plus couramment utilisé pour Node, mais ce n'est pas le seul :

nvs (Node Version Switcher) est une alternative multiplateforme à nvm, offrant la possibilité d’intégration avec VS Code.
Volta est un nouveau gestionnaire de versions de l’équipe LinkedIn, présenté comme plus rapide et offrant une prise en charge multiplateforme.

Pour installer Volta en tant que gestionnaire de versions (plutôt que windows-nvm), accédez à la section Installation sous Windows de son Guide de démarrage, puis téléchargez et exécutez le programme d'installation Windows, en suivant les instructions d'installation.

Important

Avant d'installer Volta, vous devez vous assurer que le Mode développeur est activé sur votre ordinateur Windows.

Pour en savoir plus sur l'utilisation de Volta pour installer plusieurs versions de Node.js sous Windows, consultez la documentation Volta.

Installer Visual Studio Code

Nous vous recommandons d’installer Visual Studio Code pour développer avec Node.js sur Windows. Pour obtenir de l’aide, consultez Tutoriel Node.js dans Visual Studio Code.

Autres éditeurs de code

Si vous préférez utiliser un éditeur de code ou un IDE autre que Visual Studio Code, vous pouvez également envisager les options suivantes pour votre environnement de développement Node.js :

Installer Git

Si vous envisagez de collaborer avec d’autres personnes ou d’héberger votre projet sur un site open source (comme GitHub), VS Code prend en charge le contrôle de version avec Git. L’onglet Contrôle de code source de VS Code assure le suivi de toutes vos modifications et contient des commandes Git courantes (ajouter, valider, pousser, extraire) intégrées directement dans l’interface utilisateur. Vous devez d’abord installer Git pour gérer le panneau Contrôle de code source.

Téléchargez et installez Git pour Windows sur le site web git-scm.
Vous trouverez un assistant d’installation qui vous posera une série de questions sur les paramètres de votre installation Git. Nous vous recommandons d’utiliser tous les paramètres par défaut, sauf si vous avez une raison particulière de les modifier.
Si vous n’avez jamais travaillé avec Git, les guides GitHub peuvent vous aider à démarrer.
Nous vous recommandons d'ajouter un fichier .gitignore à vos projets Node. Voici le modèle gitignore par défaut de GitHub pour Node.js.

Utiliser le Sous-système Windows pour Linux à des fins de production

L'utilisation directe de Node.js sous Windows est idéale pour l'apprentissage et l'expérimentation des possibilités qui s'offrent à vous. Si vous souhaitez créer des applications web prêtes pour la production, lesquelles sont généralement déployées sur un serveur Linux, nous vous recommandons d'utiliser le Sous-système Windows pour Linux version 2 (WSL 2) afin de développer des applications web Node.js. De nombreux packages et frameworks Node.js sont créés avec un environnement *nix à l'esprit, et la plupart des applications Node.js sont déployées sous Linux. Par conséquent, le développement sous WSL garantit la cohérence entre vos environnements de développement et de production. Pour configurer un environnement de développement WSL, consultez Configurer votre environnement de développement Node.js avec WSL 2.