Tutorials

Tutorial: npm ERR! missing script: start beheben – So läuft dein Node.js-Projekt

Melden

Hier ist ein ausführliches Tutorial auf Deutsch, wie du den Fehler „npm ERR! missing script: start“ behebst.

Wenn du in deinem Terminal npm start eingibst und die Fehlermeldung npm ERR! missing script: start erhältst, bedeutet das einfach, dass npm nicht weiß, welche Datei es ausführen soll. npm sucht in der Konfigurationsdatei deines Projekts nach einem Befehl namens "start", findet diesen aber nicht.

In dieser Anleitung lernst du Schritt für Schritt, wie du diesen Fehler behebst.

1. Die Ursache verstehen

In jedem Node.js-Projekt gibt es eine Datei namens package.json. Diese Datei enthält Metadaten über das Projekt und ein Objekt namens "scripts". Wenn du npm start tippst, sucht npm unter "scripts" nach dem Eintrag "start". Fehlt dieser Eintrag, bricht der Vorgang mit der Fehlermeldung ab.

2. Die Lösung: Das Start-Script hinzufügen

Folge diesen Schritten, um den Fehler zu beheben:

  1. Öffne deinen Projektordner in einem Code-Editor (z. B. VS Code).
  2. Suche die Datei package.json im Hauptverzeichnis und öffne sie.
  3. Suche den Abschnitt "scripts". Wenn er nicht existiert, musst du ihn erstellen.
  4. Füge die Zeile "start": "node deine-datei.js" hinzu. Ersetze deine-datei.js durch den Namen deiner Hauptdatei (meistens index.js, app.js oder server.js).

So sollte deine package.json danach aussehen:

{
  "name": "mein-projekt",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node index.js"
  },
  "author": "",
  "license": "ISC"
}

Wichtig: Achte auf das Komma am Ende der vorherigen Zeile innerhalb des Scripts-Objekts!

3. Den Befehl erneut ausführen

Speichere die package.json ab und wechsle zurück in dein Terminal. Gib nun erneut folgenden Befehl ein:

npm start

Jetzt sollte dein Node.js-Server oder dein Script ohne Fehlermeldung starten.

4. Alternative: Projekt ohne npm starten

Falls du kein Script in die package.json eintragen möchtest, kannst du dein Projekt auch direkt mit Node.js starten, indem du npm komplett umgehst. Gib dazu einfach Folgendes im Terminal ein:

node index.js

(Ersetze index.js durch deine tatsächliche Startdatei.)

5. Häufige Fehlerquellen (Checkliste)

  • Dateiname falsch: Prüfe, ob deine Hauptdatei wirklich so heißt, wie du sie im Start-Script angegeben hast (z. B. app.js vs. index.js).
  • Datei nicht gespeichert: Hast du die package.json nach den Änderungen gespeichert?
  • Falsches Verzeichnis: Befindest du dich im Terminal im selben Ordner, in dem auch die package.json liegt? Tippe ls (Mac/Linux) oder dir (Windows), um die Dateien im aktuellen Ordner zu sehen.
  • Syntax-Fehler: Fehlt ein Anführungszeichen oder ein Komma in der package.json? JSON ist hier sehr streng.

Zusammenfassung

Der Fehler „missing script: start“ ist kein Defekt deines Codes, sondern nur ein Hinweis darauf, dass der Start-Befehl in der package.json nicht definiert wurde. Durch das Hinzufügen von "start": "node dateiname.js" im Bereich "scripts" ist das Problem dauerhaft gelöst.

0