Comment utiliser npm sur Ubuntu : Installation, commandes de base et guide de dépannage

.

1. Introduction

Pourquoi utiliser npm sur Ubuntu

L’un des outils indispensables tant pour le développement front‑end que back‑end est npm (Node Package Manager). npm est largement utilisé comme gestionnaire de paquets pour Node.js, permettant aux développeurs d’installer et de gérer facilement les bibliothèques et outils JavaScript.

En utilisant npm sur Ubuntu, vous pouvez profiter des performances légères de Linux et d’une gestion de paquets flexible tout en améliorant considérablement l’efficacité du développement. Ubuntu est une distribution soutenue par une grande communauté de développeurs et est largement employée, que ce soit pour l’administration de serveurs ou pour des environnements de développement locaux.

En particulier, lorsque vous travaillez avec des frameworks basés sur Node.js tels que Vue.js, React et Next.js, la gestion des paquets avec npm est la méthode standard. Installer ces outils sur Ubuntu vous permet de créer un environnement de développement stable avec moins de problèmes comparé à Windows ou macOS.

Objectif de cet article

Cet article propose un guide pas à pas pour installer npm sur Ubuntu et maîtriser son utilisation de base. Il s’adresse surtout aux publics suivants :

• Développeurs novices sous Ubuntu
• Ceux qui rencontrent des difficultés avec l’installation de Node.js ou npm
• Toute personne souhaitant apprendre npm de manière structurée

Différentes méthodes d’installation sont présentées, avec leurs caractéristiques, avantages et inconvénients. De plus, ce guide couvre les erreurs courantes, les astuces de dépannage et les commandes utiles pour aider les lecteurs à utiliser npm sans encombre sur Ubuntu.

2. Installation de Node.js et npm sur Ubuntu

Pour utiliser npm sur Ubuntu, vous devez d’abord installer Node.js. Comme npm est fourni avec Node.js, l’installation de Node.js rend npm disponible automatiquement.

Voici trois méthodes principales pour installer Node.js et npm sur Ubuntu. Chaque méthode possède ses propres spécificités, il est donc important de choisir celle qui correspond le mieux à votre style de développement et à vos besoins.

Méthode 1 : Utiliser le dépôt officiel d’Ubuntu

Étapes

Node.js est disponible dans les dépôts standards d’Ubuntu. C’est l’approche la plus simple et la plus adaptée aux débutants.

sudo apt update
sudo apt install nodejs npm

Après l’installation, vous pouvez vérifier les versions avec les commandes suivantes :

node -v
npm -v

Avantages

• Commandes simples et faciles à comprendre
• Versions stables fournies par Ubuntu

Inconvénients

• Les versions de Node.js et npm sont souvent obsolètes, les dernières fonctionnalités peuvent ne pas être disponibles

Méthode 2 : Utiliser le PPA NodeSource

En utilisant le dépôt NodeSource, qui suit de près le support officiel de Node.js, vous pouvez installer des versions plus récentes de Node.js et npm.

Étapes (exemple : installation de Node.js 18.x)

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

npm est installé automatiquement avec Node.js.

Avantages

• Accès à des versions relativement récentes et stables
• Installation facile avec une bonne compatibilité Ubuntu

Inconvénients

• Comme pour les autres PPA, la gestion des dépendances peut être nécessaire

Méthode 3 : Utiliser nvm (Node Version Manager)

Si vous souhaitez basculer entre plusieurs versions de Node.js, nvm est l’option la plus flexible et puissante.

Étapes

Installez d’abord nvm :

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

Rechargez ensuite votre shell et installez Node.js via nvm :

source ~/.bashrc  # or ~/.zshrc
nvm install 18
nvm use 18

npm est installé automatiquement avec Node.js.

Avantages

• Basculement libre entre les versions de Node.js
• Possibilité de définir la version appropriée par projet
• Sécurisé, car cela n’affecte pas le système globalement

Inconvénients

• Configuration légèrement plus complexe que les autres méthodes
• Nécessite la modification des fichiers de configuration du shell

Quelle méthode choisir ?

French.En général, nvm est l’option la plus recommandée pour le développement npm à long terme sur Ubuntu. Cependant, si vous souhaitez une configuration rapide et simple, l’utilisation du PPA NodeSource est également un choix solide.

3. Utilisation de base de npm

Une fois Node.js et npm installés sur Ubuntu, vous pouvez commencer à gérer les paquets avec npm. npm est un outil puissant pour installer, mettre à jour et supprimer des paquets JavaScript.

Cette section présente les commandes npm les plus couramment utilisées et les opérations de base.

Installation de paquets

Installation locale

Les paquets utilisés uniquement au sein d’un projet spécifique doivent être installés localement. C’est l’approche standard. Les paquets sont installés dans le répertoire node_modules et enregistrés dans package.json.

npm install package-name

Exemple : Installation de axios

npm install axios

Seuls les scripts du même projet peuvent utiliser les paquets installés localement.

Installation globale

Les outils utilisés à l’échelle du système, comme les utilitaires en ligne de commande, doivent être installés globalement.

npm install -g package-name

Exemple : Installation de http-server globalement

sudo npm install -g http-server

Sur Ubuntu, l’utilisation de -g peut nécessiter sudo.

Désinstallation de paquets

Suppression des paquets locaux

npm uninstall package-name

Suppression des paquets globaux

sudo npm uninstall -g package-name

Mise à jour des paquets

Mise à jour d’un paquet spécifique

npm update package-name

Mise à jour de toutes les dépendances

npm update

Les mises à jour sont appliquées dans les plages de versions spécifiées dans package.json, il faut donc faire attention aux contraintes de version.

Installation des dépendances de développement (–save-dev)

Les paquets destinés uniquement au développement, comme les outils de test ou de construction, doivent être installés avec l’option --save-dev.

npm install --save-dev package-name

Exemple : Installation de jest en tant que dépendance de développement

npm install --save-dev jest

Cela enregistre le paquet sous devDependencies dans package.json.

Liste des paquets installés

Lister les paquets locaux

npm list

Lister les paquets globaux

npm list -g --depth=0

Utiliser --depth=0 n’affiche que les paquets de niveau supérieur, rendant la sortie plus lisible.

Gestion des dépendances avec package.json

Le fichier package.json est un composant central des projets basés sur npm. Il enregistre les noms des paquets, leurs versions, les scripts et la configuration globale du projet.

Vous pouvez le créer en utilisant :

npm init

Pour une configuration simplifiée avec des valeurs par défaut :

npm init -y

4. Problèmes courants et solutions

Lorsque vous utilisez npm sur Ubuntu, vous pouvez rencontrer des erreurs ou des comportements inattendus. Cette section présente les problèmes courants et comment les résoudre.

Erreurs de permission

Symptôme

EACCES: permission denied

Cause

Cela se produit lorsque l’utilisateur actuel n’a pas les droits d’écriture sur le répertoire où npm tente d’installer les paquets. Sur Ubuntu, écrire dans des répertoires système comme /usr/lib/node_modules nécessite sudo.

Solution

• Exécuter avec sudo :

  sudo npm install -g package-name
  

• Ou changer le répertoire d’installation global vers un chemin appartenant à l’utilisateur :

  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  

Ajoutez ce qui suit à ~/.bashrc ou ~/.profile :

export PATH="$HOME/.npm-global/bin:$PATH"

Appliquez les changements :

source ~/.bashrc

Commande npm introuvable

Symptôme

command not found: npm

Cause

• L’installation de Node.js ou npm a échoué
• La variable d’environnement PATH n’est pas configurée

Solution

Vérifiez le chemin :

which npm

Si rien n’est retourné, réinstallez ou vérifiez les paramètres du PATH. Si vous utilisez nvm, assurez‑vous que le code d’initialisation se trouve dans votre fichier de configuration du shell :

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Échecs d’installation de paquets ou conflits de version

Symptômes

• Conflits de version lors de l’installation d’un package
• Nombreux avertissements pendant npm install

Solutions

npm install package-name@latest

npm ls package-name

npm install --legacy-peer-deps

rm -rf node_modules package-lock.json
npm install

Commandes de débogage utiles

• npm doctor

  npm doctor
  

• npm audit

  npm audit
  npm audit fix
  

5. Questions fréquemment posées (FAQ)

Q1. Comment puis-je mettre à jour npm vers la dernière version sur Ubuntu ?

A1.

sudo npm install -g npm@latest

Si vous utilisez nvm, sudo n’est pas requis.

Q2. Quelle est la différence entre l’installation globale et locale ?

A2.

• Installation locale : Dépendances spécifiques au projet stockées dans node_modules
• Installation globale : Outils CLI système-wide, souvent nécessitant sudo

Q3. Quels sont les avantages de l’utilisation de nvm ?

A3.

nvm vous permet de basculer entre plusieurs versions de Node.js de manière sûre et efficace, ce qui en fait un outil idéal pour le développement multi-projets.

Q4. Que dois-je faire si les dépendances npm se cassent ?

A4.

rm -rf node_modules package-lock.json
npm install

Q5. Les messages npm WARN et audit sont-ils un problème ?

A5.

Les avertissements ne sont pas fatals mais indiquent des problèmes potentiels. Pour les avertissements liés à la sécurité, vous pouvez essayer :

npm audit fix

Q6. Que puis-je construire avec npm sur Ubuntu ?

A6.

• Frameworks frontend (React, Vue, Svelte)
• Générateurs de sites statiques (Next.js, Nuxt)
• Applications backend (Express, NestJS)
• Outils CLI
• Environnements de test

6. Conclusion : Maîtriser npm sur Ubuntu

Cet article a couvert les essentiels de l’installation et de l’utilisation de npm sur Ubuntu, de la configuration au dépannage.

L’étape la plus importante est d’expérimenter en pratique. En exécutant des commandes et en comprenant les messages d’erreur, vous approfondirez progressivement vos compétences en tant que développeur.

Ceci conclut le guide complet pour utiliser npm sur Ubuntu. Nous espérons que cela vous aide à construire un environnement de développement plus efficace et puissant.