- 1 1. Introduction : Pourquoi utiliser Node.js sur Ubuntu?
- 2 2. Aperçu des méthodes d’installation de Node.js sur Ubuntu
- 3 3. Méthode ① : Installer Node.js facilement avec APT (Ubuntu officiel)
- 4 4. Méthode ② : Installation de la dernière version avec le PPA NodeSource
- 5 5. Méthode ③ : Gestion flexible des versions avec nvm (recommandée)
- 6 6. Utilisation de npm et yarn
- 7 7. Erreurs courantes et dépannage
- 8 8. Questions fréquemment posées (FAQ)
- 9 9. Conclusion : choisissez la méthode d’installation adaptée à vos besoins
1. Introduction : Pourquoi utiliser Node.js sur Ubuntu?
Excellente compatibilité entre Ubuntu et Node.js
Node.js est une plateforme permettant d’exécuter du JavaScript côté serveur et est largement utilisée pour les applications web et le développement d’outils. Ubuntu, quant à lui, est une distribution Linux reconnue par de nombreux développeurs et administrateurs de serveurs. En combinant les deux, vous pouvez créer un environnement de développement qui excelle en stabilité, flexibilité et rapidité.
L’installation de Node.js sur Ubuntu offre les avantages suivants :
- Un système d’exploitation léger avec un encombrement minimal, permettant une utilisation efficace des ressources système
- Un environnement unifié basé sur Linux, du développement aux tests en passant par la production
- Une grande compatibilité avec Node.js et une intégration fluide avec des outils tels que npm et nvm
Pour ces raisons, la combinaison d’Ubuntu et de Node.js est très attrayante comme environnement de développement tant pour le front‑end que le back‑end.
Public cible et objectif de cet article
Cet article est rédigé pour les lecteurs suivants :
- Ceux qui souhaitent utiliser Node.js sur Ubuntu pour la première fois
- Ceux qui veulent savoir quelle méthode d’installation est la meilleure
- Ceux qui désirent la dernière version de Node.js mais ne sont pas sûrs de la configuration
En lisant cet article, vous pourrez comparer trois méthodes d’installation différentes de Node.js sur Ubuntu et choisir l’approche la plus adaptée à vos objectifs et à votre niveau de compétence. De plus, ce guide couvre les outils associés tels que npm et yarn, ainsi que les solutions aux erreurs courantes, vous aidant à utiliser un environnement Node.js en toute confiance.
2. Aperçu des méthodes d’installation de Node.js sur Ubuntu
Trois méthodes d’installation, chacune avec ses propres caractéristiques
Il existe trois façons principales d’installer Node.js sur Ubuntu :
- Installation du paquet standard via APT (Advanced Package Tool)
- Installation via le PPA NodeSource (Personal Package Archive)
- Utilisation de nvm (Node Version Manager) pour une gestion flexible des versions
Chaque méthode possède ses avantages et inconvénients, et le meilleur choix dépend de votre cas d’utilisation et de la configuration de votre système. Le tableau suivant résume leurs caractéristiques.
Tableau comparatif des méthodes d’installation de Node.js
| Installation Method | Main Features | Advantages | Disadvantages | Recommended For |
|---|---|---|---|---|
| APT (Default) | Uses Ubuntu’s official repository | Simple and safe | Version may be outdated | Beginners who want to try quickly |
| NodeSource PPA | Manages newer Node.js versions via APT | Relatively up-to-date versions | Requires adding a PPA | Developers who want a stable recent version |
| nvm | Supports switching between multiple versions | Highly flexible and ideal for development | Requires shell configuration | Recommended for learning and development |
Pourquoi la comparaison est‑elle importante ?
Ubuntu privilégie la stabilité, ce qui signifie que les versions des logiciels dans le dépôt APT ont tendance à être conservatrices. En conséquence, les utilisateurs qui souhaitent les dernières fonctionnalités de Node.js ou qui ont besoin de tester plusieurs versions devraient envisager des options autres que APT.
En revanche, si votre objectif est simplement d’essayer Node.js rapidement ou d’éviter une configuration supplémentaire sur un serveur de production, la méthode APT peut être suffisante.
Quelle méthode choisir ?
En conclusion, pour les développeurs ou toute personne prévoyant d’utiliser Node.js sur le long terme, l’installation via nvm est l’approche la plus recommandée.
Les raisons incluent :
- Changement facile entre les dernières et les anciennes versions
- npm est installé automatiquement
- Moins de problèmes de permissions (pas de sudo requis)
3. Méthode ① : Installer Node.js facilement avec APT (Ubuntu officiel)
Qu’est‑ce que APT ? Le système de gestion de paquets standard sur Ubuntu
APT (Advanced Package Tool) est le système de gestion de paquets standard utilisé par Ubuntu et les autres distributions Linux basées sur Debian. Avec APT, vous pouvez installer, mettre à jour et supprimer des logiciels facilement avec une seule commande.
Le dépôt officiel d’Ubuntu inclut les paquets Node.js, ce qui signifie que vous pouvez installer Node.js immédiatement sans aucune préparation particulière.
Étapes d’installation
- Mettez à jour la liste des paquets APT.
sudo apt update
- Installez Node.js et npm.
sudo apt install nodejs npm
- Vérifiez l’installation.
node -v npm -v
Si les informations de version s’affichent, l’installation a réussi.
Avantages : Simple et sûr
- Très fiable puisqu’il utilise le dépôt officiel d’Ubuntu
- Commandes simples, faciles pour les débutants
- Intégré aux mises à jour du système via APT
.### Inconvénients : La version peut être obsolète
Parce que APT privilégie la stabilité, la version de Node.js disponible peut avoir plusieurs générations de retard.
Par exemple, sur Ubuntu 22.04, la version de Node.js installée via APT peut être la version 12 ou 14, ce qui signifie que les dernières fonctionnalités et améliorations de sécurité peuvent ne pas être incluses.
Cette méthode n’est également pas adaptée si vous devez utiliser plusieurs versions de Node.js selon les projets.
À qui cette méthode convient le mieux
- Débutants qui souhaitent essayer Node.js immédiatement
- Environnements de production où une version stable suffit
- Utilisateurs qui n’ont pas besoin de plusieurs versions de Node.js
4. Méthode ② : Installation de la dernière version avec le PPA NodeSource
Qu’est‑ce que NodeSource ?
NodeSource est un fournisseur de confiance qui fournit rapidement des versions stables et récentes de Node.js, indépendamment de l’équipe officielle de Node.js. C’est particulièrement utile pour les utilisateurs d’Ubuntu et de Debian qui souhaitent installer des versions plus récentes de Node.js tout en continuant d’utiliser APT.
Cette méthode est recommandée sur le site officiel de Node.js et est largement utilisée dans les environnements d’entreprise.
Étapes d’installation (exemple : Node.js 18.x)
- Mettre à jour la liste des paquets.
sudo apt update
- Installer curl s’il n’est pas déjà présent.
sudo apt install curl
- Exécuter le script d’installation de NodeSource.
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
- Installer Node.js.
sudo apt install -y nodejs
- Vérifier l’installation.
node -v npm -v
Avantages : Utiliser la dernière version avec APT
- Installation facile de la version stable la plus récente de Node.js
- Gestion familière basée sur APT
- npm est installé automatiquement
Inconvénients : Nécessite d’ajouter un PPA
- Légèrement plus d’étapes comparé à une installation APT standard
- Nécessite d’évaluer la fiabilité de la source (NodeSource est généralement sûr)
À qui cette méthode convient le mieux
- Développeurs qui veulent une version stable et à jour de Node.js
- Utilisateurs qui trouvent le dépôt Ubuntu insuffisant mais ne souhaitent pas utiliser nvm
- Ceux qui souhaitent conserver une gestion centralisée des paquets via APT
5. Méthode ③ : Gestion flexible des versions avec nvm (recommandée)
Qu’est‑ce que nvm ? Un outil puissant pour gérer les versions de Node.js
nvm (Node Version Manager) est un outil en ligne de commande qui permet de gérer et de basculer entre plusieurs versions de Node.js. Il est particulièrement utile pour les développeurs qui ont besoin de versions différentes selon les projets ou qui souhaitent tester à la fois les dernières versions et les versions LTS.
Avec nvm, vous pouvez créer un environnement de développement flexible entièrement dans votre compte utilisateur, sans installer Node.js au niveau du système.
Installation de nvm
- Exécuter le script d’installation avec curl.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
- Recharger votre fichier de configuration du shell.
source ~/.bashrc
Ou, si vous utilisez Zsh :
source ~/.zshrc
- Vérifier que nvm est installé.
command -v nvm
Si nvm s’affiche, l’installation a réussi.
Installation de Node.js avec nvm
- Installer la version LTS :
nvm install --lts
- Installer une version spécifique :
nvm install 18
- Basculer vers la version active :
nvm use 18
- Définir la version par défaut :
nvm alias default 18
- Vérifier les versions :
node -v npm -v
Avantages : Flexibilité et contrôle maximaux
- Plusieurs versions peuvent coexister et être changées instantanément
- npm est installé automatiquement
- Aucun sudo requis, ce qui réduit les problèmes de permissions
- Ne modifie pas l’environnement système, idéal pour le développement
Inconvénients : La configuration initiale demande de l’attention
- nvm ne fonctionnera pas si les fichiers de configuration du shell ne sont pas correctement chargés
- Installé par utilisateur, pas au niveau du système
À qui cette méthode convient le mieux
- Développeurs qui ont besoin de changer de version de Node.js
- Utilisateurs gérant plusieurs projets avec des exigences différentes
- Débutants qui souhaitent éviter les problèmes liés aux permissions
6. Utilisation de npm et yarn
Qu’est-ce que npm ?
npm (Node Package Manager) est un outil essentiel pour gérer les paquets Node.js. Il vous permet d’installer et de gérer facilement les bibliothèques et outils publiés par les développeurs du monde entier.
Lorsque Node.js est installé via APT, NodeSource ou nvm, npm est généralement installé automatiquement.
Vérifier la version :
npm -v
Commandes de base npm
| Action | Command Example |
|---|---|
| Install a package | npm install <package-name> |
| Install globally | npm install -g <package-name> |
| Uninstall a package | npm uninstall <package-name> |
| Initialize a project | npm init or npm init -y |
| List packages | npm list or npm list -g |
Qu’est-ce que yarn ?
yarn est une alternative à npm développée par Facebook, conçue pour une gestion des paquets plus rapide et plus fiable. Ses commandes sont largement compatibles avec npm.
Installation de yarn (via npm)
npm install -g yarn
Vérifier l’installation :
yarn -v
Commandes de base yarn
| Action | Command Example |
|---|---|
| Install a package | yarn add <package-name> |
| Global install | yarn global add <package-name> |
| Uninstall a package | yarn remove <package-name> |
| Initialize a project | yarn init |
| List packages | yarn list or yarn global list |
npm vs yarn : lequel choisir ?
| Comparison | npm | yarn |
|---|---|---|
| Standard | Included with Node.js | Requires installation |
| Speed | Standard | Faster with caching |
| Lock file | package-lock.json | yarn.lock |
| Compatibility | – | Mostly compatible |
Le npm moderne (v7 et ultérieur) s’est considérablement amélioré, donc les deux options sont généralement acceptables. Il est préférable de suivre ce que votre projet ou votre équipe utilise déjà.
7. Erreurs courantes et dépannage
Problèmes courants et solutions
■ node: command not found
Cause :
Node.js n’est pas installé correctement, ou le PATH n’est pas défini. Cela se produit souvent après l’installation de nvm sans recharger la configuration du shell.
Solution :
- Recharger le fichier de configuration du shell :
source ~/.bashrc
- Si le problème persiste, déconnectez‑vous puis reconnectez‑vous ou redémarrez
■ E: Unable to locate package nodejs
Cause :
La liste des paquets APT est obsolète ou le PPA correct n’a pas été ajouté.
Solution :
- Mettre à jour la liste APT :
sudo apt update
- Si vous utilisez NodeSource, relancez le script d’installation
■ npm ERR! permission denied
Cause :
Permissions insuffisantes lors de l’installation de paquets npm globaux.
Solution :
- Utiliser sudo (pas toujours recommandé) :
sudo npm install -g <package-name>
- Utiliser nvm est la meilleure pratique pour éviter les problèmes de permissions
■ nvm: command not found
Cause :
nvm est installé, mais le fichier de configuration du shell n’a pas été chargé.
Solution :
- S’assurer que nvm est sourcé dans votre fichier de configuration du shell
- Le charger manuellement :
export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
Bonnes pratiques pour éviter les problèmes
- Vérifiez toujours les paramètres du PATH
- Utiliser nvm aide à éviter la plupart des problèmes liés à l’environnement
- Faites attention à la compatibilité entre Ubuntu et les versions de Node.js
8. Questions fréquemment posées (FAQ)
Q1. Comment vérifier ma version de Node.js ?
R. Exécutez la commande suivante dans le terminal :
node -v
Pour vérifier npm également :
npm -v
Q2. Comment utiliser plusieurs versions de Node.js sur Ubuntu ?
R. Utiliser nvm est la méthode la plus simple et la plus sûre. Après l’installation, vous pouvez changer de version ainsi :
nvm install 16
nvm use 16
Q3. Node.js installé via nvm n’est pas actif. Pourquoi ?
R. Dans la plupart des cas, le fichier de configuration du shell n’a pas été chargé. Exécutez :
source ~/.bashrc
Ou, pour Zsh :
source ~/.zshrc
Q4. Quelle est la différence entre npm et yarn ?
R. Leur fonctionnalité de base est similaire, mais yarn propose des installations plus rapides grâce au cache et un verrouillage explicite des dépendances via yarn.lock. Le npm moderne s’est considérablement amélioré, donc les deux options fonctionnent bien.
Q5. En quoi Node.js, Deno et Bun diffèrent-ils ?
R. Deno et Bun sont des environnements d’exécution alternatifs conçus pour pallier les limites de Node.js.
- Deno : support natif de TypeScript, sécurité renforcée, bibliothèque standard intégrée
- Bun : exécution plus rapide et gestion de paquets intégrée
Cependant, Node.js reste le choix le plus pratique grâce à son vaste écosystème npm.
9. Conclusion : choisissez la méthode d’installation adaptée à vos besoins
Il existe plusieurs façons d’installer Node.js sur Ubuntu, chacune avec des forces et des cas d’utilisation clairs. Cet article a présenté trois méthodes représentatives et expliqué comment choisir la plus adaptée.
APT (Officiel Ubuntu)
- Avantages : Le plus simple et le plus sûr
- Inconvénients : La version peut être obsolète
- Recommandé pour : Les débutants qui veulent un démarrage rapide
NodeSource PPA
- Avantages : Installer des versions plus récentes tout en utilisant APT
- Inconvénients : Nécessite l’ajout d’un PPA
- Recommandé pour : Les développeurs qui veulent une version récente stable
nvm (Node Version Manager)
- Avantages : Changement flexible de version et environnement propre
- Inconvénients : Configuration légèrement plus complexe
- Recommandé pour : Les développeurs gérant plusieurs projets
Ce guide a également couvert npm, yarn et des conseils de dépannage courants. Bien que l’installation de Node.js puisse sembler complexe au début, choisir la bonne méthode rend facile la construction d’un environnement de développement stable sur Ubuntu.
Si vous prévoyez d’étendre vos projets plus loin, utiliser nvm comme base vous aidera à évoluer vers le développement en équipe et les flux de travail CI/CD.
