Tutorial: Fehler "npm does not support Node.js" beheben

Melden

Hier ist ein ausführliches Tutorial, wie du den Fehler behebst, wenn deine Node.js-Version zu alt für npm ist.

Dieser Fehler tritt auf, wenn die installierte Version von npm (dem Node Package Manager) Funktionen nutzt, die in deiner alten Node.js-Version (wie v10.19.0) noch nicht vorhanden sind. Die Lösung besteht darin, Node.js auf eine aktuelle LTS-Version (Long Term Support) zu aktualisieren.


Methode 1: Empfohlene Lösung über NVM (Node Version Manager)

Der beste Weg, Node.js zu verwalten, ist der Node Version Manager (nvm). Damit kannst du problemlos zwischen Versionen wechseln.

  1. NVM installieren (falls nicht vorhanden):

    • Linux/macOS: Gib folgenden Befehl im Terminal ein: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    • Windows: Lade „nvm-windows“ von GitHub herunter und installiere es.
  2. Die aktuelle LTS-Version installieren: Öffne ein neues Terminal und gib ein:

    nvm install --lts
  3. Die neue Version nutzen:

    nvm use --lts
  4. Prüfen:

    node -v
    npm -v

Methode 2: Update unter Windows oder macOS (Direkter Installer)

Wenn du keinen Version-Manager nutzen möchtest, kannst du die Version einfach überschreiben:

  1. Gehe auf die offizielle Webseite: nodejs.org.
  2. Lade die Version herunter, die als "LTS" markiert ist (empfohlen für die meisten Nutzer).
  3. Führe die Installationsdatei aus. Der Installer erkennt die alte Version und aktualisiert sie automatisch.
  4. Starte deinen Computer oder dein Terminal neu.

Methode 3: Update unter Linux (Ubuntu/Debian) via NodeSource

Die Standard-Repositorys von Linux-Distributionen enthalten oft sehr alte Versionen (wie v10.19.0). So installierst du eine aktuelle Version:

  1. Alte Versionen entfernen (optional, aber sauberer):

    sudo apt-get remove nodejs npm
  2. NodeSource-Repository hinzufügen (Beispiel für eine aktuelle Version):

    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
  3. Node.js neu installieren:

    sudo apt-get install -y nodejs

Methode 4: Schnelle Lösung mit dem Tool "n" (Nur macOS/Linux)

Wenn du bereits Node.js installiert hast, kannst du das Paket n nutzen, um ein interaktives Update durchzuführen:

  1. Cache leeren und n installieren:

    sudo npm cache clean -f
    sudo npm install -g n
  2. Auf die stabile Version aktualisieren:

    sudo n stable

Überprüfung der Fehlerbehebung

Nachdem du eine der oben genannten Methoden durchgeführt hast, solltest du testen, ob der Fehler verschwunden ist. Gib dazu folgendes in dein Terminal ein:

node -v
# Sollte nun eine höhere Version anzeigen (z.B. v18, v20 oder höher)

npm -v
# Sollte nun ohne Fehlermeldung die Version ausgeben

Hinweis: Falls der Fehler weiterhin im Terminal deiner Entwicklungsumgebung (z.B. VS Code) erscheint, starte das Programm einmal komplett neu, damit die neuen Pfad-Variablen geladen werden.

0