Skip to content

fnm unter macOS installieren

fnm bietet mehrere Installationsmethoden unter macOS. Diese Anleitung hilft Ihnen, die am besten geeignete Methode zu wählen.

Installationsmethoden

Mit Homebrew (Empfohlen)

Homebrew ist der beliebteste Paketmanager unter macOS:

bash
# fnm installieren
brew install fnm

Mit curl-Skript

Kein Paketmanager erforderlich, direkt installieren:

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

Mit MacPorts

Wenn Sie MacPorts verwenden:

bash
port install fnm

Manuelles Herunterladen

  1. Besuchen Sie die fnm Releases-Seite
  2. Laden Sie fnm-macos.zip (Intel) oder fnm-macos-arm64.zip (Apple Silicon) herunter
  3. Extrahieren und in PATH-Verzeichnis verschieben:
bash
# 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

Shell konfigurieren

macOS verwendet standardmäßig Zsh, unterstützt aber auch Bash und Fish.

Zsh (Standard)

~/.zshrc bearbeiten:

bash
# Konfigurationsdatei öffnen
nano ~/.zshrc

# Folgenden Inhalt hinzufügen
eval "$(fnm env --use-on-cd)"

Konfiguration neu laden:

bash
source ~/.zshrc

Bash

~/.bashrc oder ~/.bash_profile bearbeiten:

bash
# Konfigurationsdatei öffnen
nano ~/.bash_profile

# Folgenden Inhalt hinzufügen
eval "$(fnm env --use-on-cd)"

Konfiguration neu laden:

bash
source ~/.bash_profile

Fish

~/.config/fish/config.fish bearbeiten:

fish
# Konfigurationsdatei öffnen
nano ~/.config/fish/config.fish

# Folgenden Inhalt hinzufügen
fnm env --use-on-c | source

Konfiguration neu laden:

fish
source ~/.config/fish/config.fish

Shell-Vervollständigung

Zsh-Vervollständigung

bash
# Vervollständigungsskript hinzufügen
fnm completions --shell zsh > ~/.zsh/completion/_fnm

# Sicherstellen, dass fpath das Vervollständigungsverzeichnis enthält
# Zu ~/.zshrc hinzufügen
fpath=(~/.zsh/completion $fpath)

# Vervollständigung aktivieren
autoload -U compinit && compinit

Oder mit oh-my-zsh:

bash
# Vervollständigungsverzeichnis erstellen
mkdir -p ~/.oh-my-zsh/completions

# Vervollständigungsskript generieren
fnm completions --shell zsh > ~/.oh-my-zsh/completions/_fnm

Bash-Vervollständigung

bash
# Vervollständigungsskript hinzufügen
fnm completions --shell bash >> ~/.bashrc

# Neu laden
source ~/.bashrc

Fish-Vervollständigung

bash
# Vervollständigungsskript generieren
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# Neu laden
source ~/.config/fish/config.fish

Spiegel in China verwenden

In Festlandchina wird empfohlen, einen Spiegel zu konfigurieren, um Downloads zu beschleunigen:

bash
# Zur Shell-Konfigurationsdatei hinzufügen
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Oder während eval angeben
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Apple Silicon (M1/M2/M3) Hinweise

fnm unterstützt Apple Silicon vollständig:

  • Erkennt automatisch die Systemarchitektur
  • Installiert native ARM64-Version von Node.js
  • Unterstützt x64-Emulation (über Rosetta 2)

x64-Version installieren

Wenn Sie die x64-Version von Node.js benötigen:

bash
# x64-Architektur Node.js installieren
fnm install 20 --arch=x64

Installation überprüfen

bash
# fnm-Version prüfen
fnm --version

# Node.js installieren
fnm install --lts

# Node.js überprüfen
node --version
npm --version

Häufige Probleme

Befehl nicht gefunden

Wenn der fnm Befehl nach der Installation nicht gefunden wird:

bash
# fnm-Pfad prüfen
which fnm

# Wenn mit curl installiert, sicherstellen, dass PATH enthält
echo $PATH

# Manuell zu PATH hinzufügen
export PATH="$HOME/.fnm:$PATH"

Berechtigungsprobleme

Wenn Sie Berechtigungsprobleme haben:

bash
# Sicherstellen, dass Verzeichnis korrekte Berechtigungen hat
chmod +x ~/.fnm/fnm

Homebrew-Installation funktioniert nicht

bash
# Neu verknüpfen
brew unlink fnm && brew link fnm

# Installation prüfen
brew list fnm

Nächste Schritte

Nach der Installation können Sie: