Instalar fnm en macOS

fnm tiene múltiples métodos de instalación en macOS. Esta guía te ayudará a elegir el método más adecuado.

Métodos de Instalación

Usando Homebrew (Recomendado)

Homebrew es el gestor de paquetes más popular en macOS:

# Instalar fnm
brew install fnm

Usando Script curl

No requiere gestor de paquetes, instalar directamente:

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

Usando MacPorts

Si usas MacPorts:

port install fnm

Descarga Manual

1. Visita la página de Releases de fnm
2. Descarga fnm-macos.zip (Intel) o fnm-macos-arm64.zip (Apple Silicon)
3. Extraer y mover al directorio del PATH:

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

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

Configurar Shell

macOS usa Zsh por defecto, pero también soporta Bash y Fish.

Zsh (Predeterminado)

Editar ~/.zshrc:

# Abrir archivo de configuración
nano ~/.zshrc

# Añadir el siguiente contenido
eval "$(fnm env --use-on-cd)"

Recargar configuración:

source ~/.zshrc

Bash

Editar ~/.bashrc o ~/.bash_profile:

# Abrir archivo de configuración
nano ~/.bash_profile

# Añadir el siguiente contenido
eval "$(fnm env --use-on-cd)"

Recargar configuración:

source ~/.bash_profile

Fish

Editar ~/.config/fish/config.fish:

# Abrir archivo de configuración
nano ~/.config/fish/config.fish

# Añadir el siguiente contenido
fnm env --use-on-c | source

Recargar configuración:

source ~/.config/fish/config.fish

Autocompletado del Shell

Autocompletado de Zsh

# Añadir script de autocompletado
fnm completions --shell zsh > ~/.zsh/completion/_fnm

# Asegurar que fpath incluya el directorio de autocompletado
# Añadir a ~/.zshrc
fpath=(~/.zsh/completion $fpath)

# Habilitar autocompletado
autoload -U compinit && compinit

O usando oh-my-zsh:

# Crear directorio de autocompletado
mkdir -p ~/.oh-my-zsh/completions

# Generar script de autocompletado
fnm completions --shell zsh > ~/.oh-my-zsh/completions/_fnm

Autocompletado de Bash

# Añadir script de autocompletado
fnm completions --shell bash >> ~/.bashrc

# Recargar
source ~/.bashrc

Autocompletado de Fish

# Generar script de autocompletado
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# Recargar
source ~/.config/fish/config.fish

Usar Mirror en China

En China continental, se recomienda configurar un mirror para acelerar las descargas:

# Añadir al archivo de configuración del Shell
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

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

Notas para Apple Silicon (M1/M2/M3)

fnm soporta completamente Apple Silicon:

• Detecta automáticamente la arquitectura del sistema
• Instala la versión nativa ARM64 de Node.js
• Soporta emulación x64 (vía Rosetta 2)

Instalar Versión x64

Si necesitas la versión x64 de Node.js:

# Instalar Node.js de arquitectura x64
fnm install 20 --arch=x64

Verificar Instalación

# Verificar versión de fnm
fnm --version

# Instalar Node.js
fnm install --lts

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

Problemas Comunes

Comando No Encontrado

Si el comando fnm no se encuentra después de la instalación:

# Verificar ruta de fnm
which fnm

# Si se instaló mediante curl, asegurar que PATH lo incluya
echo $PATH

# Añadir manualmente al PATH
export PATH="$HOME/.fnm:$PATH"

Problemas de Permisos

Si encuentras problemas de permisos:

# Asegurar que el directorio tenga los permisos correctos
chmod +x ~/.fnm/fnm

La Instalación de Homebrew No Funciona

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

# Verificar instalación
brew list fnm

Siguientes Pasos

Después de la instalación, puedes:

• Instalar Node.js - Usar fnm para instalar Node.js
• Referencia de Comandos - Aprender todos los comandos disponibles
• Gestión de Versiones - Aprender gestión de versiones

Enlaces Relacionados

• Instalar fnm - Guía de instalación general
• Instalación en Windows - Guía de instalación en Windows
• Instalación en Linux - Guía de instalación en Linux