Tutorials

Tutorial: npm is not recognized as an internal or external command – Gelöst

Melden

Hier ist ein umfassendes Tutorial, wie du den Fehler „npm is not recognized as internal or external command“ unter Windows dauerhaft behebst.

Dieser Fehler tritt auf, wenn Windows den Pfad zur ausführbaren Datei von Node.js und npm nicht kennt. Er lässt sich in wenigen Schritten durch das Anpassen der Umgebungsvariablen beheben.

Schritt 1: Überprüfen, ob Node.js installiert ist

Bevor du Einstellungen änderst, stelle sicher, dass Node.js überhaupt auf deinem System installiert ist.

  1. Öffne den Explorer und navigiere zu: C:\Program Files\nodejs.
  2. Prüfe, ob dort eine Datei namens node.exe und npm.cmd liegt.
  3. Falls der Ordner nicht existiert, lade Node.js von der offiziellen Website (nodejs.org) herunter und installiere es.

Schritt 2: Den Pfad zu npm manuell hinzufügen

Wenn Node.js installiert ist, der Fehler aber weiterhin erscheint, fehlt der Eintrag in den Umgebungsvariablen.

  1. Drücke die Windows-Taste und suche nach "Umgebungsvariablen".
  2. Wähle den Punkt "Systemumgebungsvariablen bearbeiten".
  3. Klicke im neuen Fenster unten auf den Button Umgebungsvariablen.
  4. Suche im Bereich Systemvariablen (unten) nach der Variable Path (oder Pfad) und klicke auf Bearbeiten.
  5. Klicke auf Neu und füge die folgenden zwei Pfade hinzu (ersetze den Pfad, falls du Node an einem anderen Ort installiert hast):
    • C:\Program Files\nodejs\
    • %AppData%\npm
  6. Bestätige alle Fenster mit OK.

Schritt 3: Terminal neu starten

Damit die Änderungen wirksam werden, musst du alle offenen Terminal-Fenster (CMD, PowerShell, VS Code Terminal) schließen und neu öffnen.

  1. Schließe deine aktuelle Eingabeaufforderung.
  2. Drücke Win + R, tippe cmd ein und drücke Enter.
  3. Gib nun folgenden Befehl ein:
    npm -v

    Wenn eine Versionsnummer erscheint, ist der Fehler behoben!

Schritt 4: Alternative – Neuinstallation (Reparatur)

Falls die manuelle Pfad-Eingabe zu kompliziert erscheint, kannst du die Installation reparieren:

  1. Starte die Node.js-Installationsdatei (.msi), die du heruntergeladen hast.
  2. Wähle die Option "Repair" (Reparieren).
  3. Achte darauf, dass im Installations-Assistenten der Punkt "Add to PATH" aktiviert ist.
  4. Starte deinen Computer nach der Installation neu.

Zusammenfassung der häufigsten Pfade

Sollte dein System Node.js an einem anderen Ort installiert haben, sind dies die Orte, die in die Variable Path gehören:

  • Haupt-Installation: C:\Program Files\nodejs\ (Hier liegt die npm.cmd).
  • Globale Pakete: C:\Users\DEIN_NAME\AppData\Roaming\npm (Hier werden global installierte Tools gespeichert).

Tipp: Nutze in der CMD den Befehl where node oder where npm, um zu sehen, ob Windows die Dateien jetzt finden kann. Wenn dort ein Pfad ausgegeben wird, ist alles korrekt konfiguriert.

0