Mettre à jour Node.js : guide complet par étapes

Depuis que je travaille comme développeur web, j’ai vu passer des dizaines de versions de Node.js. Chaque mise à jour apporte son lot de correctifs de sécurité, d’améliorations de performances et de nouvelles fonctionnalités. Pourtant, beaucoup de développeurs repoussent cette opération par crainte de casser leur environnement. Je vous propose un guide complet pour mettre à jour Node.js sereinement, quelle que soit votre plateforme.

Pourquoi mettre à jour Node.js régulièrement

Garder une version obsolète de Node.js expose votre projet à des vulnérabilités de sécurité connues. L’équipe Node.js publie régulièrement des correctifs critiques ; rester sur une version en fin de vie signifie que vous ne recevez plus ces patchs. Selon la page officielle des versions Node.js, chaque branche majeure bénéficie d’un support actif de 18 mois, puis d’un support de maintenance de 12 mois supplémentaires.

Au-delà de la sécurité, les nouvelles versions apportent des gains de performance mesurables. Le moteur V8 intégré à Node.js est optimisé à chaque itération : compilation plus rapide, consommation mémoire réduite, meilleure gestion de la concurrence. Par exemple, Node.js 22 a introduit des améliorations significatives du ramasse-miettes et du démarrage à froid.

Les frameworks modernes comme Next.js, Nuxt ou Astro exigent désormais des versions minimales de Node.js. Si vous travaillez sur la création d’une application mobile avec un backend Node, rester à jour vous garantit la compatibilité avec l’écosystème npm.

Vérifier sa version actuelle de Node.js

Avant toute mise à jour, commencez par identifier la version installée sur votre machine. Ouvrez un terminal et tapez :

node -v
npm -v

La première commande retourne la version de Node.js (par exemple v18.20.3), la seconde celle de npm. Notez ces deux informations : elles vous serviront de référence si vous devez revenir en arrière.

Pour connaître toutes les versions disponibles à l’installation, utilisez :

nvm ls-remote --lts

Cette commande liste uniquement les versions LTS (Long Term Support), celles que je recommande systématiquement pour les projets professionnels. Si vous n’avez pas encore NVM installé, pas d’inquiétude : je détaille la procédure dans la section suivante.

Mettre à jour Node.js avec NVM (Linux et macOS)

NVM (Node Version Manager) est l’outil que j’utilise au quotidien. Il permet de gérer plusieurs versions de Node.js en parallèle, ce qui est indispensable quand on jongle entre différents projets. Voici comment procéder étape par étape.

Installer NVM

Si NVM n’est pas encore présent sur votre machine, exécutez la commande suivante :

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Fermez puis rouvrez votre terminal, ou exécutez source ~/.bashrc (ou ~/.zshrc selon votre shell). Vérifiez l’installation avec nvm --version.

Installer la dernière version LTS

nvm install --lts

Cette commande télécharge et installe automatiquement la dernière version LTS de Node.js. Elle devient la version active dans votre terminal courant.

Définir la version par défaut

nvm alias default node

Cette ligne indique à NVM d’utiliser la dernière version installée par défaut dans tous les nouveaux terminaux. Vous pouvez aussi fixer une version précise :

nvm alias default 22

Basculer entre les versions

nvm use 18
nvm use 22

La commande nvm use vous permet de changer de version instantanément, sans rien désinstaller. C’est particulièrement utile quand vous maintenez un projet legacy sur Node 18 tout en développant un nouveau projet sur Node 22. Cette flexibilité rappelle les bonnes pratiques que l’on retrouve en approche DevOps, où l’on isole les environnements pour éviter les conflits.

Mettre à jour Node.js sur Windows

Sur Windows, plusieurs options s’offrent à vous pour mettre à jour Node.js. Je vais détailler les deux méthodes les plus fiables.

Méthode 1 : le programme d’installation officiel

C’est la méthode la plus simple. Rendez-vous sur le site officiel de Node.js, téléchargez le fichier .msi de la version souhaitée, puis lancez l’installateur. Il détecte automatiquement la version existante et la remplace. C’est un processus similaire au téléchargement initial, comparable à un simple node js download classique.

Méthode 2 : nvm-windows

L’outil nvm-windows (à ne pas confondre avec NVM pour Linux) offre la même flexibilité de gestion multi-versions. Pour l’installer :

1. Désinstallez d’abord toute version existante de Node.js via le Panneau de configuration
2. Téléchargez nvm-windows depuis son dépôt GitHub officiel
3. Exécutez le fichier d’installation
4. Ouvrez un nouveau terminal PowerShell en mode administrateur

Ensuite, les commandes sont similaires :

nvm install 22
nvm use 22

Méthode 3 : Chocolatey ou winget

Si vous utilisez un gestionnaire de paquets, la mise à jour se fait en une ligne :

choco upgrade nodejs-lts
# ou avec winget
winget upgrade OpenJS.NodeJS.LTS

Je recommande winget aux développeurs sur Windows 11, car il est intégré nativement au système.

Mettre à jour Node.js sur Ubuntu et Debian

Le paquet nodejs disponible dans les dépôts par défaut d’Ubuntu est souvent très en retard par rapport à la version officielle. Sur Ubuntu 22.04, par exemple, le dépôt fournit Node.js 12, ce qui est largement obsolète. Voici comment obtenir une version récente.

Via NodeSource

NodeSource maintient des dépôts APT mis à jour pour Ubuntu et Debian. Pour installer Node.js 22 :

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Cette méthode ajoute le dépôt NodeSource à vos sources APT. Les futures mises à jour se feront via sudo apt-get update && sudo apt-get upgrade.

Via NVM (recommandé)

Sur Ubuntu, je préfère personnellement utiliser NVM plutôt que les dépôts système. La procédure est identique à celle décrite plus haut pour Linux. L’avantage : aucun sudo nécessaire pour installer ou changer de version, ce qui renforce la sécurité de votre environnement, un point essentiel quand on s’intéresse aux bonnes pratiques de sécurité en environnement cloud.

Via Snap

sudo snap install node --classic --channel=22

Cette méthode fonctionne mais peut poser des problèmes de permissions avec certains paquets npm globaux. Elle reste néanmoins une alternative valide pour mettre à jour Node.js en ligne de commande rapidement.

Mettre à jour npm vers la dernière version

Chaque version de Node.js embarque une version de npm, mais celle-ci n’est pas toujours la plus récente. Après avoir mis à jour Node.js, je vous conseille systématiquement de mettre à jour npm séparément :

npm install -g npm@latest

Vérifiez ensuite avec npm -v. Si vous rencontrez des erreurs de permissions sur Linux ou macOS, c’est souvent parce que Node.js a été installé via le gestionnaire de paquets système avec sudo. C’est une raison supplémentaire de privilégier NVM.

Pensez aussi à mettre à jour npx, qui est inclus avec npm depuis la version 5.2. Si vous utilisez des outils comme create-react-app ou create-next-app, une version récente de npx garantit que vous obtenez toujours les derniers modèles de projet.

Pour les développeurs qui travaillent avec TypeScript et ses énumérations, noter qu’une mise à jour de Node.js peut nécessiter de vérifier la compatibilité avec votre version de ts-node ou tsx.

Migrer de Node.js 18 vers Node.js 22

La migration de Node.js 18 vers Node.js 22 est l’une des questions que je reçois le plus souvent. Node.js 18 arrive en fin de support en septembre 2025 ; il est donc temps de planifier cette transition.

Changements majeurs à anticiper

Voici les points de rupture les plus fréquents lors du passage de la version 18 à la version 22 :

• Le moteur V8 passe à la version 12.x, ce qui active de nouvelles fonctionnalités ECMAScript (Array.groupBy, Promise.withResolvers)
• Le module fs/promises adopte de nouveaux comportements pour certaines fonctions
• Le flag --experimental-modules n’est plus nécessaire ; les ESM sont pleinement supportés
• Certains anciens algorithmes de chiffrement sont retirés d’OpenSSL
• Le fetch API global est désormais stable (plus besoin de node-fetch dans la plupart des cas)

Procédure de migration pas à pas

1. Créez une branche dédiée dans votre dépôt Git
2. Installez Node.js 22 via NVM : nvm install 22
3. Basculez sur cette version : nvm use 22
4. Supprimez le dossier node_modules et le fichier package-lock.json
5. Réinstallez les dépendances : npm install
6. Lancez vos tests : npm test
7. Corrigez les éventuelles erreurs de compatibilité
8. Mettez à jour le champ engines dans votre package.json

{
  "engines": {
    "node": ">=22.0.0"
  }
}

Cette approche méthodique est essentielle, surtout dans un contexte d’ingénierie DevOps où les pipelines CI/CD doivent refléter la bonne version de Node.

Calendrier des versions LTS de Node.js

Comprendre le cycle de vie des versions Node.js vous aide à planifier vos mises à jour. Voici le calendrier officiel maintenu par l’équipe Release de Node.js sur GitHub :

Node.js 24 deviendra bien une version LTS en octobre 2025. Les versions paires suivent systématiquement ce cycle : six mois en phase Current, puis passage en LTS. Les versions impaires (21, 23, 25) ne reçoivent jamais de support long terme ; elles servent de terrain d’expérimentation.

Pour un projet en production, je recommande toujours de rester sur la dernière version LTS active. En juillet 2026, cela signifie Node.js 22 ou Node.js 24 selon votre tolérance au changement.

Bonnes pratiques après une mise à jour

Mettre à jour Node.js ne se limite pas à changer de binaire. Voici les étapes que je suis systématiquement après chaque montée de version :

Vérifier les dépendances

npm outdated

Cette commande affiche la liste des paquets qui ne sont plus à jour. Profitez-en pour mettre à jour ceux qui ont des correctifs de sécurité. L’outil npm audit complète cette vérification en identifiant les vulnérabilités connues.

Nettoyer le cache npm

npm cache clean --force

Après un changement de version majeure, le cache peut contenir des artéfacts incompatibles. Un nettoyage évite des erreurs d’installation difficiles à diagnostiquer.

Reconstruire les modules natifs

npm rebuild

Certains paquets comme bcrypt, sharp ou sqlite3 utilisent des bindings C++ compilés pour une version précise de Node.js. La commande npm rebuild recompile ces modules pour la nouvelle version.

Mettre à jour le fichier .nvmrc

Si votre projet utilise un fichier .nvmrc à la racine, mettez-le à jour pour que tous les membres de l’équipe utilisent la même node version :

echo "22" > .nvmrc

Ce fichier, combiné à la commande nvm use, garantit la cohérence entre les environnements de développement. C’est une pratique que l’on retrouve dans les principes d’ingénierie DevOps.

Adapter la CI/CD

N’oubliez pas de mettre à jour la version de Node.js dans vos fichiers de configuration d’intégration continue. Que vous utilisiez GitHub Actions, GitLab CI ou Jenkins, vérifiez que la matrice de tests reflète la nouvelle version. Un exemple pour GitHub Actions :

strategy:
  matrix:
    node-version: [22.x, 24.x]

Si vous estimez le coût de développement d’une application, intégrez le temps de mise à jour des dépendances dans votre budget ; c’est une charge récurrente souvent sous-estimée.