Skip to content

fnm use Befehl Anleitung

Der fnm use Befehl wird verwendet, um die aktuell verwendete Node.js-Version zu wechseln.

Befehlssyntax

bash
fnm use [OPTIONEN] [VERSION]

Parameter

VERSION

Gibt die zu wechselnde Node.js-Version an:

bash
# Zu Hauptversion wechseln
fnm use 20

# Zu bestimmter Version wechseln
fnm use 20.10.0

# Alias verwenden
fnm use default

# Keine Version angegeben, liest aus Versionsdatei
fnm use

Optionen

--install-if-missing

Automatisch installieren, wenn die Version nicht bereits installiert ist:

bash
fnm use 18 --install-if-missing

--silent-if-unchanged

Keine Ausgabe, wenn die Version unverändert bleibt:

bash
fnm use 20 --silent-if-unchanged

--node-dist-mirror

Wird mit --install-if-missing verwendet, um Download-Spiegel anzugeben:

bash
fnm use 18 --install-if-missing --node-dist-mirror=https://npmmirror.com/mirrors/node

--fnm-dir

fnm Installationsverzeichnis angeben:

bash
fnm use 20 --fnm-dir=/custom/path

--log-level

Protokollierungsstufe einstellen:

bash
fnm use 20 --log-level=quiet

Verwendungsbeispiele

Basiswechsel

bash
# Zu Node.js 20 wechseln
fnm use 20

# Zu Node.js 18.17.0 wechseln
fnm use 18.17.0

Automatische Installation und Wechsel

bash
# Automatisch installieren, wenn Version nicht installiert ist
fnm use 16 --install-if-missing

Wechsel über Alias

bash
# Voreingestellten Alias verwenden
fnm use default
fnm use legacy

Lautloser Modus

bash
# In Skripten verwenden, um unnötige Ausgabe zu vermeiden
fnm use 20 --silent-if-unchanged

Versionsauswahl-Priorität

Wenn keine Version angegeben wird, sucht fnm in der folgenden Reihenfolge:

  1. .node-version Datei
  2. .nvmrc Datei
  3. package.json engines.node
  4. Standardversion

Unterschied zum default Befehl

  • fnm use - Wechselt Version für aktuelle Shell-Sitzung
  • fnm default - Setzt globale Standardversion
bash
# Standardversion setzen (betrifft neue Terminals)
fnm default 20

# Version temporär wechseln (nur aktuelles Terminal)
fnm use 18

Häufige Probleme

Version nicht installiert

bash
# Fehlermeldung
error: Can't find version 18.0.0

# Lösung: Automatisch installieren
fnm use 18 --install-if-missing

node Version ändert sich nach Wechsel nicht

Stellen Sie sicher, dass die Shell-Konfiguration korrekt ist:

bash
# node Pfad prüfen
which node

# Sollte auf fnm Verzeichnis zeigen
# ~/.fnm/node-versions/.../bin/node

Versionsdatei funktioniert nicht

bash
# Bestätigen, dass --use-on-cd aktiviert ist
eval "$(fnm env --use-on-cd)"

# Bestätigen, dass Versionsdatei existiert
cat .node-version