For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /de/docs/web/terminal-basics.md (or send Accept: text/markdown).
Befehle, Dateien und Konfiguration
Erfahren Sie, wo Sie Befehle einfügen, den richtigen Projektordner öffnen, .env-Dateien bearbeiten, einen Server stoppen und einen Setup-Fehler melden, ohne Geheimnisse preiszugeben.
Ein Befehl geht in das Terminal
Ein Terminal ist das Fenster, in dem Sie Anweisungen für Ihren Computer eingeben. Öffnen Sie in Visual Studio Code zunächst Ihren Supastack-Ordner über Datei → Ordner öffnen und wählen Sie dann Terminal → Neues Terminal. Das neue Terminal startet in diesem Ordner. Unter Windows wählen Sie PowerShell über das Menü neben der +-Taste des Terminals. Verwenden Sie macOS/Linux-Blöcke in einem macOS- oder Linux-Terminal.
Fügen Sie jeweils nur den Inhalt eines Befehlsblocks ein und drücken Sie die Eingabetaste. Fügen Sie nicht die umgebenden Markdown-Backticks, eine Eingabeaufforderung wie PS C:\... oder eine Beispielausgabe ein. Zeilen, die mit # beginnen, sind Erläuterungen; Sie führen nichts aus. Warten Sie, bis jeder Installationsbefehl abgeschlossen ist, bevor Sie den nächsten Befehl eingeben. Ein Serverbefehl wird weiter ausgeführt und gibt erst dann eine neue Eingabeaufforderung zurück, wenn Sie ihn stoppen.
Überprüfen Sie, welchen Ordner das Terminal verwendet
Repository-Root bezeichnet den Supastack-Ordner der obersten Ebene, der package.json, pnpm-workspace.yaml, Apps und Pakete enthält. Sofern in einem Schritt nichts anderes angegeben ist, führen Sie die Befehle dort aus. Der folgende Befehl druckt den aktuellen Ordner; In der Dateiliste sollte „package.json“ angezeigt werden. Unter Windows funktionieren PowerShell pwd und ls auch.
Wenn in der Auflistung nur der Inhalt von apps/web oder apps/mobile angezeigt wird, geben Sie cd ../.. ein und drücken Sie die Eingabetaste, um zum Stammverzeichnis zurückzukehren. Wenn Ihr Home-Ordner angezeigt wird, geben Sie cd ein, gefolgt von einem Leerzeichen und dem vollständigen Pfad zu Ihrem Klon, der in Anführungszeichen gesetzt wird, wenn er Leerzeichen enthält. Meistens ist es einfacher, den Projektordner im Editor zu öffnen und ein neues Terminal zu erstellen.
pwd
lsDie Konfiguration erfolgt in einer Datei, nicht im Terminal
Ein Block wie AI_PROVIDER=fake ist Konfigurationstext. Öffnen Sie die benannte .env-Datei im Editor, suchen Sie die Zeile, die mit AI_PROVIDER= beginnt, ersetzen Sie ihren Wert und speichern Sie mit Strg + S (Befehl + S unter macOS). Jede Einstellung belegt eine Zeile im KEY=value-Format. Fügen Sie keine Markdown-Backticks hinzu. Vermeiden Sie doppelte Kopien desselben Schlüssels in einer Datei.
Verwenden Sie root .env für Datenbankmigrationsbefehle, apps/web/.env.local für den Next.js-Webserver und apps/mobile/.env.local für Expo. Next und Expo werden in ihren eigenen App-Ordnern ausgeführt und laden die Root-.env-Datei nicht automatisch. Wenn sich eine Datenbankverbindung ändert, aktualisieren Sie DATABASE_URL sowohl in Root .env als auch in apps/web/.env.local, damit Migrationen und der Server dieselbe Datenbank verwenden. Bewahren Sie die Beispieldatei zum späteren Nachschlagen unverändert auf.
Dateien, deren Namen mit einem Punkt beginnen, sind möglicherweise in Ihrem Dateimanager ausgeblendet. Der Explorer des Herausgebers zeigt sie an. Stellen Sie sicher, dass der Dateiname genau .env.local und nicht .env.local.txt lautet. Diese lokalen Dateien können Passwörter enthalten und sind von Git ausgeschlossen; Laden Sie sie nicht hoch und fügen Sie ihren Inhalt nicht in Support-Nachrichten ein.
Halten Sie den Server am Laufen. Verwenden Sie ein anderes Terminal für Befehle
Der Entwicklungsserver stellt Ihre App bereit, während Sie arbeiten. Lassen Sie das Terminal geöffnet, wenn in einem Tutorial „localhost:3000 öffnen“ angezeigt wird. localhost bedeutet dieser Computer; :3000 ist der Port, wie eine nummerierte Tür, die von der App verwendet wird. Geben Sie den URL in die Adressleiste Ihres Browsers ein, nicht in das Terminal.
Um einen anderen Befehl auszuführen, während der Server aktiv ist, wählen Sie im Editor Terminal → Neues Terminal. Das neue Terminal ist ein separates Fenster im selben Projekt. Um den Server zu stoppen, wählen Sie sein Terminal aus und drücken Sie einmal Strg + C. Wenn Sie unter Windows gefragt werden, ob Sie den Batch-Job beenden möchten, geben Sie „Y“ ein und drücken Sie die Eingabetaste. Warten Sie auf die normale Eingabeaufforderung, bevor Sie den Vorgang erneut starten.
Stoppen Sie nach dem Bearbeiten der Webumgebungseinstellungen den Webserver und starten Sie ihn mit dem folgenden Befehl neu. Beim Speichern einer Quelldatei wird die Seite normalerweise automatisch aktualisiert, bei Umgebungsänderungen ist jedoch ein Neustart erforderlich. Nachdem Sie die Expo-Einstellungen bearbeitet haben, stoppen Sie Expo und führen Sie dann corepack pnpm --filter @supastack/mobile start --clear aus, um neu zu starten und das zwischengespeicherte Bundle zu löschen.
corepack pnpm --filter @supastack/web devLesen Sie einen Fehler und bitten Sie um nützliche Hilfe
Wenn eine Installation einen roten Fehlertext zurückgibt, stoppen Sie bei diesem Schritt. Lesen Sie den ersten Fehler, anstatt die App weiter zu starten. Befehl nicht gefunden bedeutet normalerweise, dass ein Werkzeug fehlt; Kein package.json bedeutet normalerweise, dass es sich um den falschen Ordner handelt. ECONNREFUSED bedeutet normalerweise, dass ein erforderlicher Server oder eine erforderliche Datenbank nicht ausgeführt wird. EADDRINUSE bedeutet, dass ein anderer Prozess den Port bereits verwendet.
Wenn Sie um Hilfe bitten, geben Sie Ihr Betriebssystem, die Anleitung URL und die Schrittnummer, den genauen Befehl, den Sie eingegeben haben, und die erste Fehlermeldung an. Entfernen Sie Passwörter, API Schlüssel, Token und den Passwortteil jeder Datenbank URL. Senden Sie Ihre .env-Dateien nicht. Ein Screenshot des Fehlers kann hilfreich sein, kopierbarer Text ist jedoch einfacher zu diagnostizieren.