Skip to content

Guida Comando use di fnm

Il comando fnm use viene utilizzato per cambiare la versione di Node.js attualmente in uso.

Sintassi Comando

bash
fnm use [OPZIONI] [VERSIONE]

Parametri

VERSIONE

Specifica la versione di Node.js a cui cambiare:

bash
# Cambia a versione principale
fnm use 20

# Cambia a versione specifica
fnm use 20.10.0

# Usa alias
fnm use default

# Nessuna versione specificata, legge dal file versione
fnm use

Opzioni

--install-if-missing

Installa automaticamente la versione se non è già installata:

bash
fnm use 18 --install-if-missing

--silent-if-unchanged

Non mostra messaggio se la versione non cambia:

bash
fnm use 20 --silent-if-unchanged

--node-dist-mirror

Usato con --install-if-missing per specificare mirror download:

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

--fnm-dir

Specifica directory installazione fnm:

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

--log-level

Imposta livello log:

bash
fnm use 20 --log-level=quiet

Esempi Utilizzo

Cambio Base

bash
# Cambia a Node.js 20
fnm use 20

# Cambia a Node.js 18.17.0
fnm use 18.17.0

Installa Automaticamente e Cambia

bash
# Installa automaticamente se la versione non è installata
fnm use 16 --install-if-missing

Cambio Tramite Alias

bash
# Usa alias preimpostati
fnm use default
fnm use legacy

Modalità Silenziosa

bash
# Usa negli script per evitare output non necessari
fnm use 20 --silent-if-unchanged

Priorità Selezione Versione

Quando non viene specificata una versione, fnm cerca nel seguente ordine:

  1. File .node-version
  2. File .nvmrc
  3. package.json campo engines.node
  4. Versione predefinita

Differenza dal Comando default

  • fnm use - Cambia versione per la sessione Shell corrente
  • fnm default - Imposta versione predefinita globale
bash
# Imposta versione predefinita (influenza nuovi terminali)
fnm default 20

# Cambia temporaneamente versione (solo terminale corrente)
fnm use 18

Problemi Comuni

Versione Non Installata

bash
# Messaggio di errore
error: Can't find version 18.0.0

# Soluzione: Installa automaticamente
fnm use 18 --install-if-missing

Versione node Non Cambia Dopo Cambio

Assicurati che la configurazione Shell sia corretta:

bash
# Controlla percorso node
which node

# Dovrebbe puntare alla directory fnm
# ~/.fnm/node-versions/.../bin/node

File Versione Non Funziona

bash
# Conferma che --use-on-cd è abilitato
eval "$(fnm env --use-on-cd)"

# Conferma che il file versione esiste
cat .node-version