Skip to content

Installer Node.js avec fnm

fnm rend l'installation et la gestion des versions de Node.js simples et rapides. Ce guide détaillera comment utiliser fnm pour installer Node.js.

Démarrage Rapide

Installer la Dernière Version LTS

bash
fnm install --lts

Installer la Dernière Version

bash
fnm install --latest

Installer une Version Spécifique

bash
fnm install 20
fnm install 18.17.0

Méthodes d'Installation Expliquées

Installer une Version LTS

Les versions LTS (Long Term Support) de Node.js sont recommandées pour les environnements de production:

bash
# Installer la dernière version LTS
fnm install --lts

# Installer une version LTS spécifique
fnm install lts/iron    # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x
fnm install lts/gallium  # Node.js 16.x

Noms de Code des Versions LTS:

Nom de CodeVersionStatut
Iron20.xLTS Active
Hydrogen18.xMaintenance
Gallium16.xFin de Vie

Installer une Version Spécifique

bash
# Installer la version majeure (sélectionne automatiquement la dernière version mineure)
fnm install 20

# Installer une version spécifique
fnm install 20.10.0

# Installer une ancienne version
fnm install 14.21.3

Installer en Utilisant un Fichier de Version

Créez un fichier .node-version ou .nvmrc dans le répertoire du projet:

bash
# Créer un fichier .node-version
echo "20" > .node-version

# fnm lira et installera automatiquement
fnm install

Utiliser Après l'Installation

Changer vers la Version Installée

bash
# Utiliser une version spécifique
fnm use 20

# Si la version n'est pas installée, installer automatiquement puis utiliser
fnm use 18 --install-if-missing

Définir la Version Par Défaut

bash
# Définir la version par défaut
fnm default 20

# Afficher la version par défaut actuelle
fnm default

Utiliser Immédiatement Après l'Installation

bash
# Installer et changer vers la version immédiatement
fnm install 20 --use

Afficher les Versions Disponibles

Afficher les Versions Distantes

bash
# Lister toutes les versions disponibles
fnm list-remote

# Lister uniquement les versions LTS
fnm list-remote --lts

# Filtrer des versions spécifiques
fnm list-remote --filter=18

# Afficher les dernières versions
fnm list-remote --latest

Afficher les Versions Installées Localement

bash
fnm list

Exemple de sortie:

* v20.10.0 default
  v18.19.0
  v16.20.2

Utiliser un Mirror pour un Téléchargement Plus Rapide

En Chine continentale, vous pouvez utiliser un mirror pour accélérer les téléchargements:

bash
# Définir la variable d'environnement du mirror
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Ou spécifier lors de l'installation
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

Mirrors courants:

Source de MirrorURL
npmmirrorhttps://npmmirror.com/mirrors/node
Université de Tsinghuahttps://mirrors.tuna.tsinghua.edu.cn/nodejs-release

Support Corepack

fnm prend en charge Corepack, qui peut activer automatiquement Yarn et pnpm:

bash
# Activer Corepack lors de l'installation
fnm install 20 --corepack-enabled

# Ou définir une variable d'environnement
export FNM_COREPACK_ENABLED=true
fnm install 20

Meilleures Pratiques de Gestion de Version

Gestion de Version au Niveau du Projet

Créez un fichier .node-version dans la racine du projet:

bash
# Spécifier la version majeure
echo "20" > .node-version

# Ou spécifier la version exacte
echo "20.10.0" > .node-version

Combiné avec l'option --use-on-cd, change automatiquement de version en entrant dans le répertoire:

bash
# Ajouter à la configuration du Shell
eval "$(fnm env --use-on-cd)"

Développement Multi-Versions

bash
# Installer plusieurs versions
fnm install 20
fnm install 18
fnm install 16

# Changer entre différents projets
cd project-a && fnm use 20
cd project-b && fnm use 18

Utiliser des Alias

bash
# Définir des alias
fnm alias 20 default
fnm alias 18 legacy

# Changer en utilisant les alias
fnm use default
fnm use legacy

Problèmes Courants

Échec de l'Installation

Si l'installation échoue, veuillez vérifier:

  1. Si la connexion réseau est normale
  2. Si vous avez besoin de configurer un mirror
  3. S'il y a assez d'espace disque
bash
# Réessayer en utilisant un mirror
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

Le Changement de Version Ne Fonctionne Pas

Assurez-vous que le Shell est correctement configuré:

bash
# Vérifier la version actuelle
fnm current

# Vérifier le chemin node
which node

Nettoyer les Anciennes Versions

bash
# Afficher les versions installées
fnm list

# Désinstaller les versions inutiles
fnm uninstall 16.20.2

Liens Connexes