Tutorials

Tutorial: Fehler "npx is not recognized" gelöst (React JS & Node JS)

Melden

Hier ist ein ausführliches Tutorial, wie du den Fehler "The term 'npx' is not recognized" in deiner React- oder Node.js-Umgebung dauerhaft löst.

Dieser Fehler tritt auf, wenn dein Betriebssystem (meistens Windows) den Befehl npx nicht finden kann. Dies liegt entweder daran, dass Node.js nicht installiert ist oder der Pfad zu den ausführbaren Dateien nicht in den Umgebungsvariablen hinterlegt wurde.

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

npx wird automatisch mit Node.js installiert. Zuerst müssen wir prüfen, ob Node.js überhaupt auf deinem System vorhanden ist.

  1. Öffne dein Terminal (CMD, PowerShell oder Git Bash).
  2. Gib folgenden Befehl ein:
    node -v
  3. Ergebnis:
    • Wenn eine Versionsnummer erscheint (z. B. v18.x.x), ist Node installiert. Gehe zu Schritt 3.
    • Wenn dort ebenfalls steht "not recognized", fahre mit Schritt 2 fort.

Schritt 2: Node.js installieren oder reparieren

Falls Node.js nicht installiert ist, kann npx nicht funktionieren.

  1. Gehe auf die offizielle Webseite: nodejs.org.
  2. Lade die LTS-Version (empfohlen für die meisten Nutzer) herunter.
  3. Führe den Installer aus.
  4. Wichtig: Achte darauf, dass während der Installation der Haken bei "Add to PATH" gesetzt ist.
  5. Starte deinen Computer nach der Installation neu.

Schritt 3: Die Umgebungsvariablen (PATH) manuell anpassen

Dies ist die häufigste Ursache. Windows weiß nicht, wo sich die npx.cmd befindet.

  1. Drücke die Windows-Taste und suche nach "Umgebungsvariablen" (oder "Environment Variables").
  2. Klicke auf "Systemumgebungsvariablen bearbeiten".
  3. Klicke im neuen Fenster unten auf den Button Umgebungsvariablen.
  4. Suche im unteren Bereich ("Systemvariablen") die Zeile Path und klicke auf Bearbeiten.
  5. Prüfe, ob folgende Pfade vorhanden sind. Falls nicht, klicke auf "Neu" und füge sie hinzu:
    • C:\Program Files\nodejs\
    • %AppData%\npm (Dies ist der Ort, an dem npx oft liegt)
  6. Bestätige alles mit OK.

Schritt 4: Terminal neu starten (Wichtig!)

Änderungen an den Pfaden werden nicht in bereits geöffneten Terminals übernommen.

  1. Schließe VS Code, die PowerShell oder das CMD-Fenster komplett.
  2. Öffne ein neues Terminal.
  3. Versuche erneut, die Version zu prüfen:
    npx -v

    Nun sollte eine Versionsnummer erscheinen.

Schritt 5: Problem in VS Code (PowerShell Execution Policy)

Falls der Fehler nur im integrierten Terminal von VS Code auftritt, kann es an den Berechtigungen der PowerShell liegen.

  1. Öffne die PowerShell als Administrator.
  2. Gib folgenden Befehl ein:
    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  3. Bestätige mit Y (Ja).

Zusammenfassung & Erfolgskontrolle

Wenn du alles korrekt ausgeführt hast, kannst du nun dein React-Projekt ohne Probleme starten:

npx create-react-app mein-projekt

Zusammenfassende Checkliste bei Fehlern:

  • Node.js installiert?
  • Terminal nach Installation neu gestartet?
  • Pfad C:\Program Files\nodejs\ in den Umgebungsvariablen hinterlegt?
  • Befehl node -v und npm -v funktionieren?

Damit ist das Problem "npx is not recognized" dauerhaft behoben!

0