Node Version Manager (NVM) est un outil essentiel pour les développeurs JavaScript qui ont besoin de gérer plusieurs versions de Node.js sur leur machine. Cela est particulièrement utile lorsque différents projets nécessitent des versions spécifiques de Node.js. Bien que NVM soit principalement conçu pour les systèmes Unix, il existe une version adaptée pour Windows, appelée NVM for Windows. Ce tutoriel vous guidera à travers les étapes d’installation et de configuration de NVM sur Windows 11, vous permettant ainsi de basculer facilement entre différentes versions de Node.js.
Étapes d’Installation de NVM sur Windows 11
1. Vérifier les installations
Avant d’installer NVM, assurez-vous que Node.js n’est pas déjà installé sur votre système. Pour vérifier, ouvrez une invite de commande et tapez :
node -v
Si une version de Node.js est affichée, désinstallez-la via les paramètres de votre système !
2. Téléchargez l’exécutable et installez NVM pour Windows
Rendez-vous sur la page des releases de NVM for Windows sur GitHub et téléchargez l’exécutable nvm-setup.exe.
https://github.com/coreybutler/nvm-windows
- Une fois téléchargé, lancez le fichier d’installation et suivez les instructions :
- Acceptez l’accord de licence.
- Confirmez le chemin d’installation.
- Confirmez le répertoire pour le lien symbolique de Node.js.
- Cliquez sur Install puis sur Finish
3. Vérifier l’installation
Pour vérifier que NVM est correctement installé, ouvrez une invite de commande et tapez :
nvm -v
4. Configurer les variables d’environnement
Accédez aux Propriétés Système > Variables d’environnement et ajoutez les variables suivantes :
NVM_SYMLINK
:C:\Program Files\nodejs
NVM_HOME
: le chemin où NVM est installé (par exemple,C:\Users\User\AppData\Roaming\nvm
)
Dans la variable Path
, ajoutez :
%NVM_HOME%
%NVM_SYMLINK%
Erreurs courantes :
NVM pour Windows peut ne pas parvenir à créer ou mettre à jour correctement le symlink, le lien symbolique, vers la version de Node.js que vous souhaitez utiliser.
Dans ce cas, vous devez indiquer manuellement le chemin dans la valeur de la variable :
Nom de la variable : NVM_SYMLINK
Valeur de la variable : C:\Users\User\AppData\Roaming\nvm\v16.20.2
Pour accéder au dossier AppData, qui est caché par défaut, utilisez la combinaison de touches Win + R, puis tapez %appdata%
et appuyez sur Entrée.
Vous pouvez aussi entrer la commande : cat ~/.nvm/settings.txt pour configurer Nvm.
5. Installez et utilisez différentes versions de Node.js
Pour installer une version spécifique de Node.js, utilisez la commande suivante dans l’invite de commande :
nvm install <version>
Versions LTS :
- 20.16.0
- 18.20.4
- 16.20.2
- 14.21.3
https://nodejs.org/fr/download/prebuilt-installer
Par exemple, pour installer la version 18.20.4 (ancienne version utilisée par une application en particulier):
nvm install 18.20.4
Pour voir toutes les versions de Node.js installées :
nvm list
Pour utiliser une version spécifique :
nvm use 18.20.4
Un message apparaîtra : Now using node v18.20.4 (64-bit)
Une étoile apparaîtra sur la version en cours
22.16.0
* 18.20.4
Configurez VSCode pour Utiliser NVM
Vous devez aussi vous assurer que votre éditeur de code utilise le même environnement que le votre terminal.
Ouvrez la Palette de commandes dans VSCode et accédez aux Paramètres.
Ouvrez settings.json
et remplacez C:\Program Files\nodejs
par le chemin où NVM installe les versions de Node.js.
"terminal.integrated.env.windows": {"PATH": "${env:PATH};C:\\Program Files\\nodejs"},
Enregistrez et fermez le fichier.
Redémarrez VSCode et vérifiez la version de Node.js utilisée.
node -v
L’installation de NVM sur Windows 11 est un processus simple qui vous permet de gérer efficacement plusieurs versions de Node.js, facilitant ainsi le développement de projets nécessitant différentes versions.
En suivant ce tutoriel, vous pourrez installer, configurer et utiliser NVM pour basculer entre les versions de Node.js selon vos besoins, optimisant ainsi votre environnement de développement.
Si vous utilisez d’autres outils pour gérer les versions de Node.js, il pourrait y avoir un conflit de configuration.
Ressources
NVM.Sh NVM pour Unix utilise un script bash. Il est conçu pour les environnements POSIX (diverses versions d’Unix, Linux, et même certaines versions de Windows avec des couches de compatibilité).
Fmn Un autre gestionnaire de versions NodeJS léger et rapide
Bugs courants avec NVM Windows