Skip to content

Installa Node.js con fnm

fnm rende semplice e veloce installare e gestire le versioni di Node.js. Questa guida dettaglierà come usare fnm per installare Node.js.

Avvio Rapido

Installa Ultima Versione LTS

bash
fnm install --lts

Installa Ultima Versione

bash
fnm install --latest

Installa Versione Specifica

bash
fnm install 20
fnm install 18.17.0

Metodi Installazione Spiegati

Installa Versione LTS

Le versioni LTS (Long Term Support) di Node.js sono consigliate per ambienti di produzione:

bash
# Installa ultima versione LTS
fnm install --lts

# Installa versione LTS specifica
fnm install lts/iron    # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x
fnm install lts/gallium  # Node.js 16.x

Nomi in Codice Versioni LTS:

NomeVersioneStato
Iron20.xLTS Attiva
Hydrogen18.xManutenzione
Gallium16.xFine Vita

Installa Versione Specifica

bash
# Installa versione principale (seleziona automaticamente ultima versione minor)
fnm install 20

# Installa versione specifica
fnm install 20.10.0

# Installa versione vecchia
fnm install 14.21.3

Installa Usando File Versione

Crea un file .node-version o .nvmrc nella directory del progetto:

bash
# Crea file .node-version
echo "20" > .node-version

# fnm leggerà e installerà automaticamente
fnm install

Usa Dopo Installazione

Cambia a Versione Installata

bash
# Usa versione specifica
fnm use 20

# Se versione non è installata, installa automaticamente poi usa
fnm use 18 --install-if-missing

Imposta Versione Predefinita

bash
# Imposta versione predefinita
fnm default 20

# Visualizza versione predefinita corrente
fnm default

Usa Immediatamente Dopo Installazione

bash
# Installa e cambia alla versione immediatamente
fnm install 20 --use

Visualizza Versioni Disponibili

Visualizza Versioni Remote

bash
# Elenca tutte le versioni disponibili
fnm list-remote

# Elenca solo versioni LTS
fnm list-remote --lts

# Filtra versioni specifiche
fnm list-remote --filter=18

# Visualizza ultime versioni
fnm list-remote --latest

Visualizza Versioni Installate Localmente

bash
fnm list

Esempio output:

* v20.10.0 default
  v18.19.0
  v16.20.2

Usa Mirror per Download Più Veloce

Nella Cina continentale, puoi usare un mirror per accelerare i download:

bash
# Imposta variabile ambiente mirror
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# O specifica durante installazione
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

Mirror comuni:

Sorgente MirrorURL
npmmirrorhttps://npmmirror.com/mirrors/node
Tsinghua Universityhttps://mirrors.tuna.tsinghua.edu.cn/nodejs-release

Supporto Corepack

fnm supporta Corepack, che può abilitare automaticamente Yarn e pnpm:

bash
# Abilita Corepack durante installazione
fnm install 20 --corepack-enabled

# O imposta variabile ambiente
export FNM_COREPACK_ENABLED=true
fnm install 20

Best Practice Gestione Versioni

Gestione Versioni a Livello Progetto

Crea un file .node-version nella directory radice del progetto:

bash
# Specifica versione principale
echo "20" > .node-version

# O specifica versione esatta
echo "20.10.0" > .node-version

Combina con opzione --use-on-cd, cambia automaticamente versioni quando entri nella directory:

bash
# Aggiungi a configurazione Shell
eval "$(fnm env --use-on-cd)"

Sviluppo Multi-Versione

bash
# Installa più versioni
fnm install 20
fnm install 18
fnm install 16

# Cambia tra progetti diversi
cd project-a && fnm use 20
cd project-b && fnm use 18

Usa Alias

bash
# Imposta alias
fnm alias 20 default
fnm alias 18 legacy

# Cambia usando alias
fnm use default
fnm use legacy

Problemi Comuni

Installazione Fallita

Se installazione fallisce, controlla:

  1. Se connessione di rete è normale
  2. Se hai bisogno di configurare un mirror
  3. Se c'è spazio disco sufficiente
bash
# Riprova usando mirror
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

Cambio Versione Non Funziona

Assicurati che Shell sia configurata correttamente:

bash
# Controlla versione corrente
fnm current

# Controlla percorso node
which node

Pulisci Versioni Vecchie

bash
# Visualizza versioni installate
fnm list

# Disinstalla versioni non necessarie
fnm uninstall 16.20.2