Installa fnm su macOS

fnm ha molteplici metodi di installazione su macOS. Questa guida ti aiuterà a scegliere il metodo più adatto.

Metodi Installazione

Usando Homebrew (Consigliato)

Homebrew è il package manager più popolare su macOS:

# Installa fnm
brew install fnm

Usando Script curl

Nessun package manager richiesto, installa direttamente:

curl -fsSL https://fnm.vercel.app/install | bash

Usando MacPorts

Se usi MacPorts:

port install fnm

Download Manuale

1. Visita pagina Releases di fnm
2. Scarica fnm-macos.zip (Intel) o fnm-macos-arm64.zip (Apple Silicon)
3. Estrai e sposti nella directory PATH:

# Apple Silicon (M1/M2/M3)
unzip fnm-macos-arm64.zip
sudo mv fnm /usr/local/bin

# Intel Mac
unzip fnm-macos.zip
sudo mv fnm /usr/local/bin

Configura Shell

macOS usa Zsh per impostazione predefinita, ma supporta anche Bash e Fish.

Zsh (Predefinito)

Modifica ~/.zshrc:

# Apri file configurazione
nano ~/.zshrc

# Aggiungi il seguente contenuto
eval "$(fnm env --use-on-cd)"

Ricarica configurazione:

source ~/.zshrc

Bash

Modifica ~/.bashrc o ~/.bash_profile:

# Apri file configurazione
nano ~/.bash_profile

# Aggiungi il seguente contenuto
eval "$(fnm env --use-on-cd)"

Ricarica configurazione:

source ~/.bash_profile

Fish

Modifica ~/.config/fish/config.fish:

# Apri file configurazione
nano ~/.config/fish/config.fish

# Aggiungi il seguente contenuto
fnm env --use-on-c | source

Ricarica configurazione:

source ~/.config/fish/config.fish

Completamento Shell

Completamento Zsh

# Aggiungi script completamento
fnm completions --shell zsh > ~/.zsh/completion/_fnm

# Assicurati che fpath includa directory completamento
# Aggiungi a ~/.zshrc
fpath=(~/.zsh/completion $fpath)

# Abilita completamento
autoload -U compinit && compinit

O usando oh-my-zsh:

# Crea directory completamento
mkdir -p ~/.oh-my-zsh/completions

# Genera script completamento
fnm completions --shell zsh > ~/.oh-my-zsh/completions/_fnm

Completamento Bash

# Aggiungi script completamento
fnm completions --shell bash >> ~/.bashrc

# Ricarica
source ~/.bashrc

Completamento Fish

# Genera script completamento
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# Ricarica
source ~/.config/fish/config.fish

Usando Mirror in Cina

Nella Cina continentale, è consigliato configurare un mirror per accelerare i download:

# Aggiungi al file configurazione Shell
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# O specifica durante eval
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Note Apple Silicon (M1/M2/M3)

fnm supporta pienamente Apple Silicon:

• Rileva automaticamente architettura di sistema
• Installa versione nativa ARM64 di Node.js
• Supporta emulazione x64 (tramite Rosetta 2)

Installa Versione x64

Se hai bisogno della versione x64 di Node.js:

# Installa architettura x64 Node.js
fnm install 20 --arch=x64

Verifica Installazione

# Controlla versione fnm
fnm --version

# Installa Node.js
fnm install --lts

# Verifica Node.js
node --version
npm --version

Problemi Comuni

Comando Non Trovato

Se comando fnm non viene trovato dopo installazione:

# Controlla percorso fnm
which fnm

# Se installato tramite curl, assicurati PATH includa
echo $PATH

# Aggiungi manualmente a PATH
export PATH="$HOME/.fnm:$PATH"

Problemi Permessi

Se incontri problemi permessi:

# Assicurati directory abbia permessi corretti
chmod +x ~/.fnm/fnm

Installazione Homebrew Non Funziona

# Re-link
brew unlink fnm && brew link fnm

# Controlla installazione
brew list fnm

Prossimi Passi

Dopo installazione, puoi:

• Installa Node.js - Usa fnm per installare Node.js
• Riferimento Comandi - Scopri tutti i comandi disponibili
• Gestione Versioni - Scopri gestione versioni

Link Correlati

• Installa fnm - Guida installazione generale
• Installazione Windows - Guida installazione Windows
• Installazione Linux - Guida installazione Linux