Wie man Node.js-Versionen unter Windows mit NVM wechselt (Schritt-für-Schritt-Anleitung)

Die Verwaltung verschiedener Node.js-Versionen unter Windows kann knifflig sein, besonders wenn jedes Projekt seine eigene Version benötigt. NVM für Windows löst dieses Problem, indem es einen einfachen Versionswechsel ermöglicht. Diese Anleitung erklärt deutlich, wie man NVM installiert und verwendet, und hebt häufige Installationsprobleme und Fehlerbehebungsschritte hervor.
Wichtige Erkenntnisse
- Verwenden Sie nvm-windows, um schnell zwischen Node.js-Versionen zu wechseln.
- Entfernen Sie vorherige Node-Installationen, um Konflikte zu vermeiden.
- Führen Sie Befehle in einem Administrator-Terminal aus, um häufige Berechtigungsprobleme zu vermeiden.
Installation von NVM für Windows
Schritt 1: Entfernen vorhandener Node-Installationen
Bevor Sie NVM installieren, deinstallieren Sie jede vorhandene Node.js-Installation, um Konflikte zu vermeiden:
- Gehen Sie zu Einstellungen > Apps und deinstallieren Sie Node.js.
- Stellen Sie sicher, dass kein
nodejs
-Ordner inC:Program Filesnodejs
verbleibt.
Installation von nvm-windows
-
Laden Sie die neueste nvm-windows-Version herunter.
-
Führen Sie
nvm-setup.exe
aus und folgen Sie den Anweisungen (verwenden Sie Standardspeicherorte). -
Öffnen Sie ein neues Terminal als Administrator und überprüfen Sie die Installation:
nvm --version
Installation der neuesten Node.js-Versionen
Mit installiertem NVM können Sie jetzt mehrere Node.js-Versionen einfach verwalten:
- Um die neueste LTS-Version zu installieren (aktuell Node.js 22.x):
nvm install lts
- Für eine bestimmte Version (z.B. Node.js 23.x):
nvm install 23.3.0
Installierte Node-Versionen auflisten:
nvm ls
Wie man Node.js-Versionen wechselt
Sobald Versionen installiert sind, ist das Wechseln einfach:
- Um eine bestimmte Version zu aktivieren:
nvm use 22.14.0
- Bestätigen Sie die aktive Version:
node -v
npm -v
Fehlerbehebung bei häufigen NVM-Problemen
Problem: NVM wechselt Node-Versionen nicht
Ursache: Eine vorherige Node-Installation existiert.
Lösung:
- Löschen oder benennen Sie den vorhandenen
C:Program Filesnodejs
-Ordner um. - Führen Sie
nvm use <version>
erneut aus.
Problem: Berechtigungsfehler (Zugriff verweigert)
Ursache: Die Erstellung von Symlinks benötigt erhöhte Rechte.
Lösung:
- Führen Sie die Eingabeaufforderung als Administrator aus, oder
- Aktivieren Sie den Windows-Entwicklermodus (Einstellungen > Update & Sicherheit > Für Entwickler).
Problem: ‘nvm’-Befehl nicht gefunden
Ursache: Pfad-Umgebungsvariable nicht aktualisiert.
Lösung: Schließen und öffnen Sie Ihr Terminal neu oder starten Sie Windows neu.
Problem: Globale npm-Pakete fehlen nach dem Wechsel
Ursache: Globale Pakete sind versionsspezifisch.
Lösung: Installieren Sie globale Pakete für jede Node.js-Version neu oder verwenden Sie lokale Installationen (npx
).
Bewährte Praktiken
- Dokumentieren Sie die Node-Version pro Projekt.
- Aktualisieren Sie nvm-windows regelmäßig und entfernen Sie ungenutzte Node-Versionen.
- Verwenden Sie Node LTS-Versionen für Stabilität.
Fazit
Die Verwendung von nvm-windows vereinfacht die Verwaltung mehrerer Node.js-Versionen unter Windows. Eine ordnungsgemäße Einrichtung und Fehlerbehebung helfen, häufige Fallstricke zu vermeiden und erleichtern Ihren Entwicklungsprozess.
FAQs
Nein, das originale NVM ist für Linux und macOS. Windows-Benutzer sollten nvm-windows verwenden.
Normalerweise wird dies durch Überreste von Node-Installationen verursacht. Entfernen oder benennen Sie alle vorhandenen Node-Installationsordner um.
Ja, es sei denn, Sie aktivieren den Entwicklermodus unter Windows.
Verwenden Sie den Befehl `nvm uninstall <version>`.
Typischerweise in `%AppData%Roamingnvm`. Jede Version wird separat installiert.