Installer fnm sur macOS

fnm dispose de plusieurs méthodes d'installation sur macOS. Ce guide vous aidera à choisir la méthode la plus appropriée.

Méthodes d'Installation

En Utilisant Homebrew (Recommandé)

Homebrew est le gestionnaire de paquets le plus populaire sur macOS:

# Installer fnm
brew install fnm

En Utilisant le Script curl

Aucun gestionnaire de paquets requis, installation directe:

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

En Utilisant MacPorts

Si vous utilisez MacPorts:

port install fnm

Téléchargement Manuel

1. Visiter la page des releases fnm
2. Télécharger fnm-macos.zip (Intel) ou fnm-macos-arm64.zip (Apple Silicon)
3. Extraire et déplacer vers un répertoire du 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

Configurer le Shell

macOS utilise Zsh par défaut, mais prend également en charge Bash et Fish.

Zsh (Par Défaut)

Éditer ~/.zshrc:

# Ouvrir le fichier de configuration
nano ~/.zshrc

# Ajouter le contenu suivant
eval "$(fnm env --use-on-cd)"

Recharger la configuration:

source ~/.zshrc

Bash

Éditer ~/.bashrc ou ~/.bash_profile:

# Ouvrir le fichier de configuration
nano ~/.bash_profile

# Ajouter le contenu suivant
eval "$(fnm env --use-on-cd)"

Recharger la configuration:

source ~/.bash_profile

Fish

Éditer ~/.config/fish/config.fish:

# Ouvrir le fichier de configuration
nano ~/.config/fish/config.fish

# Ajouter le contenu suivant
fnm env --use-on-c | source

Recharger la configuration:

source ~/.config/fish/config.fish

Complétion Shell

Complétion Zsh

# Ajouter le script de complétion
fnm completions --shell zsh > ~/.zsh/completion/_fnm

# S'assurer que fpath inclut le répertoire de complétion
# Ajouter à ~/.zshrc
fpath=(~/.zsh/completion $fpath)

# Activer la complétion
autoload -U compinit && compinit

Ou en utilisant oh-my-zsh:

# Créer le répertoire de complétion
mkdir -p ~/.oh-my-zsh/completions

# Générer le script de complétion
fnm completions --shell zsh > ~/.oh-my-zsh/completions/_fnm

Complétion Bash

# Ajouter le script de complétion
fnm completions --shell bash >> ~/.bashrc

# Recharger
source ~/.bashrc

Complétion Fish

# Générer le script de complétion
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# Recharger
source ~/.config/fish/config.fish

Utiliser un Mirror en Chine

En Chine continentale, il est recommandé de configurer un mirror pour accélérer les téléchargements:

# Ajouter au fichier de configuration du Shell
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Ou spécifier lors de l'évaluation
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Notes pour Apple Silicon (M1/M2/M3)

fnm prend entièrement en charge Apple Silicon:

• Détecte automatiquement l'architecture du système
• Installe la version native ARM64 de Node.js
• Prend en charge l'émulation x64 (via Rosetta 2)

Installer la Version x64

Si vous avez besoin de la version x64 de Node.js:

# Installer l'architecture x64 de Node.js
fnm install 20 --arch=x64

Vérifier l'Installation

# Vérifier la version de fnm
fnm --version

# Installer Node.js
fnm install --lts

# Vérifier Node.js
node --version
npm --version

Problèmes Courants

Commande Introuvable

Si la commande fnm est introuvable après l'installation:

# Vérifier le chemin de fnm
which fnm

# Si installé via curl, s'assurer que PATH inclut
echo $PATH

# Ajouter manuellement au PATH
export PATH="$HOME/.fnm:$PATH"

Problèmes de Permission

Si vous rencontrez des problèmes de permission:

# S'assurer que le répertoire a les bonnes permissions
chmod +x ~/.fnm/fnm

L'Installation Homebrew Ne Fonctionne Pas

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

# Vérifier l'installation
brew list fnm

Prochaines Étapes

Après l'installation, vous pouvez:

• Installer Node.js - Utiliser fnm pour installer Node.js
• Référence des Commandes - Découvrir toutes les commandes disponibles
• Gestion de Version - Apprendre la gestion de version

Liens Connexes

• Installer fnm - Guide d'installation général
• Installation Windows - Guide d'installation Windows
• Installation Linux - Guide d'installation Linux