Mit beobachtbarem Zustand beginnen
Prüfen Sie Wurzel und Dateien vor Änderungen: pwd, ls -la und cat package.json vermeiden Verzeichnisfehler. Sehen Sie Skripte mit npm run, Top-Level-Pakete mit npm ls und verfügbare Befehle mit help oder which.
Wenn ein Prozess aktiv ist, zeigt jobs seine ID. Den richtigen Job zu stoppen und neu zu starten ist sicherer als mehrere Server für dieselbe Aufgabe zu öffnen.
pwd
ls -la
cat package.json
npm run
npm ls
which npm
jobsSymptom und nächste Prüfung
„Befehl nicht gefunden“: help oder which ausführen und npm exec für ein lokales Binärprogramm nutzen. „Skript fehlt“: Namen mit npm run vergleichen. „Natives Paket“: Installationswarnung lesen und den Ablauf in einer Umgebung mit dem Binärprogramm ausführen.
„Preview gestoppt“: jobs prüfen, nur den Serverjob neu starten und dessen URL öffnen. „Datei fehlt“: speichern, Wurzel prüfen und nach Pfad suchen; node_modules, .git, dist und .odete werden in der Rekursionsnavigation übersprungen.
| Symptom | Prüfung |
|---|---|
| Skript fehlt | npm run |
| lokales Binärprogramm | npm exec name oder which name |
| aktiver Server | jobs |
| Port/Preview | URL des Servers |
| Textfehler | grep -rn "Begriff" src |
| Swift-Grenze | Problems und Swift Playgrounds |
Wann die Umgebung wechseln
Wechseln Sie für native Addons, Astro/Next-Build, Swift-Kompilierung, Systemintegration oder nicht implementierte Node-APIs zu Mac oder CI. Befehl, Ausgabe und Paketversion machen die Reproduktion konkret.
Vor einem Bugreport reduzieren Sie den Fall: eingegebener Befehl, Projektverzeichnis, kleinster Code und vollständige Ausgabe. So trennt man eine bekannte Odete-Grenze von einem projektspezifischen Problem.