fnm Befehlsreferenz

fnm bietet eine übersichtliche und leistungsstarke Sammlung von Kommandozeilentools zur Verwaltung von Node.js-Versionen.

Befehlsübersicht

fnm [OPTIONEN] <BEFEHL>

Globale Optionen

Option	Beschreibung	Standardwert
--node-dist-mirror <URL>	Node.js Download-Spiegel	https://nodejs.org/dist
--fnm-dir <DIR>	fnm Installationsverzeichnis	~/.fnm
--log-level <LEVEL>	Protokollierungsstufe	info
--arch <ARCH>	Architektur überschreiben	Systemarchitektur
--version-file-strategy <STRATEGIE>	Versionsdatei-Parsing-Strategie	local
--corepack-enabled	Corepack aktivieren	false
--resolve-engines	engines.node in package.json auflösen	true

Kernbefehle

fnm install

Installiert neue Node.js-Versionen.

fnm install [OPTIONEN] [VERSION]

Parameter:

• VERSION - Versionsnummer, kann teilweise semver oder LTS-Versionsname sein (z.B. lts/iron)

Optionen:

• --lts - Installiert die neueste LTS-Version
• --latest - Installiert die neueste Version
• --use - Verwendet die Version sofort nach der Installation
• --progress <auto|never|always> - Download-Fortschrittsbalken anzeigen

Beispiele:

# fnm version
fnm --version


# Installiert die neueste LTS-Version
fnm install --lts

# Installiert die neueste Version
fnm install --latest

# Installiert eine bestimmte Version
fnm install 20
fnm install 18.17.0

# Installiert eine bestimmte LTS-Version
fnm install lts/iron

# Installiert und verwendet sofort
fnm install 20 --use

fnm use

Wechselt die Node.js-Version.

fnm use [OPTIONEN] [VERSION]

Optionen:

• --install-if-missing - Automatisch installieren, wenn Version nicht installiert ist
• --silent-if-unchanged - Keine Ausgabe, wenn Version unverändert bleibt

Beispiele:

# Verwendet eine bestimmte Version
fnm use 20

# Verwendet die neueste installierte Version
fnm use

# Automatisch installieren, wenn nicht installiert
fnm use 18 --install-if-missing

fnm list

Listet lokal installierte Node.js-Versionen auf.

fnm list [OPTIONEN]

Alias: ls

Beispiel:

fnm list

Beispielausgabe:

* v20.10.0 default
  v18.19.0
  v16.20.2

fnm list-remote

Listet alle verfügbaren Remote-Node.js-Versionen auf.

fnm list-remote [OPTIONEN]

Alias: ls-remote

Optionen:

• --filter <FILTER> - Nach Versionsnummer oder semver-Bereich filtern
• --lts [<NAME>] - Nur LTS-Versionen anzeigen
• --latest - Nur neueste Versionen anzeigen
• --sort <asc|desc> - Sortierreihenfolge

Beispiele:

# Listet alle Versionen auf
fnm list-remote

# Listet nur LTS-Versionen auf
fnm list-remote --lts

# Listet eine bestimmte LTS-Version auf
fnm list-remote --lts=iron

# Filtert Versionen
fnm list-remote --filter=18

# Zeigt nur neueste Versionen
fnm list-remote --latest

fnm uninstall

Deinstalliert Node.js-Versionen.

fnm uninstall [OPTIONEN] [VERSION]

Alias: uni

Beispiele:

# Deinstalliert eine bestimmte Version
fnm uninstall 16.20.2

# Deinstalliert über Alias
fnm uninstall default

WARNING

Wenn ein Alias bereitgestellt wird, löscht fnm die Node.js-Version, auf die der Alias zeigt, sowie andere Aliase, die auf dieselbe Version zeigen.

Versionsverwaltungsbefehle

fnm default

Setzt oder ruft die Standard-Node.js-Version ab.

fnm default [VERSION]

Beispiele:

# Setzt die Standardversion
fnm default 20

# Ruft die aktuelle Standardversion ab
fnm default

fnm current

Zeigt die aktuell verwendete Node.js-Version an.

fnm current

Beispiel:

fnm current
# Ausgabe: v20.10.0

fnm alias

Setzt einen Alias für eine Version.

fnm alias <VERSION> <NAME>

Beispiele:

# Alias setzen
fnm alias 20 default
fnm alias 18 legacy

# Alias verwenden
fnm use default

fnm unalias

Löscht einen Alias.

fnm unalias <NAME>

Beispiel:

fnm unalias legacy

Umgebungskonfigurationsbefehle

fnm env

Gibt Shell-Umgebungsvariablen-Konfiguration aus.

fnm env [OPTIONEN]

Optionen:

• --shell <bash|zsh|fish|powershell> - Shell-Typ angeben
• --json - Im JSON-Format ausgeben
• --use-on-cd - Automatisches Versionsumschalt-Skript ausgeben

Beispiele:

# Gibt aktuelle Shell-Konfiguration aus
fnm env

# Gibt Bash-Konfiguration aus
fnm env --shell bash

# JSON-Format ausgeben
fnm env --json

# Automatisches Versionsumschalten aktivieren
fnm env --use-on-cd

fnm completions

Gibt Shell-Vervollständigungsskript aus.

fnm completions [OPTIONEN]

Optionen:

• --shell <bash|zsh|fish|powershell> - Shell-Typ angeben

Beispiele:

# Bash
fnm completions --shell bash >> ~/.bashrc

# Zsh
fnm completions --shell zsh >> ~/.zshrc

# Fish
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# PowerShell
fnm completions --shell powershell >> $PROFILE

Erweiterte Befehle

fnm exec

Führt einen Befehl in einer angegebenen Node.js-Version-Umgebung aus.

fnm exec [OPTIONEN] -- <BEFEHL>

Optionen:

• --using <VERSION> - Angegebene Version verwenden

Beispiele:

# Befehl mit Node.js 18 ausführen
fnm exec --using=18 -- node --version

# Skript mit bestimmter Version ausführen
fnm exec --using=20 -- npm run build

Befehls-Spickzettel

Befehl	Alias	Beschreibung
install	i	Node.js-Version installieren
use	-	Node.js-Version wechseln
list	ls	Installierte Versionen auflisten
list-remote	ls-remote	Remote-Versionen auflisten
uninstall	uni	Node.js-Version deinstallieren
default	-	Standardversion setzen/abrufen
current	-	Aktuelle Version anzeigen
alias	-	Versions-Alias setzen
unalias	-	Alias löschen
env	-	Umgebungskonfiguration ausgeben
completions	-	Vervollständigungsskript ausgeben
exec	-	Befehl in angegebener Version ausführen

Verwandte Links

• Node.js installieren - Detaillierte Installationsanleitung
• Versionsverwaltung - Best Practices für die Versionsverwaltung
• install Befehl - Detaillierte Erklärung des install-Befehls