Skip to content

Guide de la Commande fnm use

La commande fnm use est utilisée pour changer la version de Node.js actuellement utilisée.

Syntaxe de la Commande

bash
fnm use [OPTIONS] [VERSION]

Paramètres

VERSION

Spécifier la version de Node.js vers laquelle changer:

bash
# Changer vers la version majeure
fnm use 20

# Changer vers une version spécifique
fnm use 20.10.0

# Utiliser un alias
fnm use default

# Aucune version spécifiée, lit depuis le fichier de version
fnm use

Options

--install-if-missing

Installer automatiquement la version si elle n'est pas déjà installée:

bash
fnm use 18 --install-if-missing

--silent-if-unchanged

Ne pas afficher de message si la version est inchangée:

bash
fnm use 20 --silent-if-unchanged

--node-dist-mirror

Utilisé avec --install-if-missing pour spécifier le mirror de téléchargement:

bash
fnm use 18 --install-if-missing --node-dist-mirror=https://npmmirror.com/mirrors/node

--fnm-dir

Spécifier le répertoire d'installation fnm:

bash
fnm use 20 --fnm-dir=/custom/path

--log-level

Définir le niveau de log:

bash
fnm use 20 --log-level=quiet

Exemples d'Utilisation

Changement de Base

bash
# Changer vers Node.js 20
fnm use 20

# Changer vers Node.js 18.17.0
fnm use 18.17.0

Installation et Changement Automatiques

bash
# Installer automatiquement si la version n'est pas installée
fnm use 16 --install-if-missing

Changer en Utilisant un Alias

bash
# Utiliser un alias prédéfini
fnm use default
fnm use legacy

Mode Silencieux

bash
# Utiliser dans des scripts pour éviter les sorties inutiles
fnm use 20 --silent-if-unchanged

Priorité de Sélection de Version

Lorsqu'aucune version n'est spécifiée, fnm recherche dans l'ordre suivant:

  1. Fichier .node-version
  2. Fichier .nvmrc
  3. engines.node dans package.json
  4. Version par défaut

Différence avec la Commande default

  • fnm use - Change la version pour la session Shell actuelle
  • fnm default - Définit la version par défaut globale
bash
# Définir la version par défaut (affecte les nouveaux terminaux)
fnm default 20

# Changer temporairement la version (terminal actuel uniquement)
fnm use 18

Problèmes Courants

Version Non Installée

bash
# Message d'erreur
error: Can't find version 18.0.0

# Solution: Installation automatique
fnm use 18 --install-if-missing

La Version node Ne Change Pas Après le Changement

Assurez-vous que la configuration du Shell est correcte:

bash
# Vérifier le chemin node
which node

# Doit pointer vers le répertoire fnm
# ~/.fnm/node-versions/.../bin/node

Le Fichier de Version Ne Fonctionne Pas

bash
# Confirmer que --use-on-cd est activé
eval "$(fnm env --use-on-cd)"

# Confirmer que le fichier de version existe
cat .node-version

Liens Connexes