Node.js : gérer plusieurs versions (nvm)

nvm (Node Version Manager) installe plusieurs versions de Node.js dans le dossier personnel et permet de passer de l’une à l’autre. Il est adapté au développement ; pour un service système, voir Mise en production.

Installer nvm

Remplacer la version dans l’URL par la dernière publiée sur github.com/nvm-sh/nvm :

sudo apt install curl
curl -fsSL -o nvm_install.sh https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh
less nvm_install.sh            # lecture avant exécution
bash nvm_install.sh

Rouvrir le terminal (ou source ~/.bashrc), puis vérifier :

command -v nvm                 # affiche « nvm »
nvm --version

Installer des versions de Node.js

nvm ls-remote --lts            # versions LTS disponibles
nvm install --lts              # dernière LTS
nvm install 24                 # dernière version 24.x
nvm install 22.12.0            # version précise

Changer de version

nvm ls                         # versions installées
nvm use 24                     # active la version 24 dans ce terminal
node --version
nvm alias default 24           # version utilisée par défaut à l'ouverture d'un terminal
nvm current                    # version active

Une version par projet : `.nvmrc`

Placer à la racine du projet un fichier .nvmrc contenant la version :

echo "24" > .nvmrc
nvm use                        # lit .nvmrc
nvm install                    # installe la version indiquée si nécessaire

Le fichier .nvmrc se versionne avec le projet : toute l’équipe utilise la même version.

Commandes utiles

Commande	Rôle
`nvm ls`	Liste les versions installées
`nvm install --lts`	Installe la dernière LTS
`nvm use <version>`	Active une version dans le terminal courant
`nvm alias default <version>`	Définit la version par défaut
`nvm uninstall <version>`	Supprime une version
`nvm exec 22 node app.js`	Exécute une commande avec une version précise
`nvm install --lts --reinstall-packages-from=current`	Installe la LTS en gardant les paquets globaux
`nvm which 24`	Chemin de l’exécutable d’une version

Mettre à jour nvm

Relancer le script d’installation avec la nouvelle version de nvm.

Limites

Dépannage

Symptôme	Piste
`nvm: command not found`	Rouvrir le terminal, ou vérifier que `~/.bashrc` contient les lignes ajoutées par le script
`node` n’est pas celui de nvm	Un Node système est prioritaire : `which -a node` ; `nvm use` remet nvm en tête du `PATH`
Erreur de téléchargement	Vérifier la connexion et l’accès à `nodejs.org`

Pour aller plus loin

Documentation : github.com/nvm-sh/nvm