git status

Grundlegende Snapshots

Zeigt den Zustand deiner Arbeitsdateien und des Staging-Bereichs

Der Befehl 'git status' zeigt, welche Dateien du geändert hast, welche Änderungen für den nächsten Commit vorgemerkt sind und welche Dateien Git noch nicht verfolgt. Er ändert nie etwas und ist daher jederzeit sicher — führe ihn vor jedem git add und git commit aus. Er zeigt auch, auf welchem Branch du bist und, mit einem Remote, wie weit du voraus oder zurück bist.

Syntax

git status [<options>] [--] [<pathspec>...]
[ ] optional| oder<arg> Platzhalter... wiederholbar--flag Option

Optionen

Klicke auf eine Option, um sie aufzuklappen

Einsteiger (2)

Gibt die Ausgabe im Kurzformat aus: zwei Statusbuchstaben pro Datei (Staging-Bereich, dann Arbeitsverzeichnis).

EmpfohlenKompakte Alltagsansicht: zwei Statusbuchstaben pro Datei

Beispiel

git status -s

Zeigt Branch und Tracking-Infos, auch im Kurzformat.

EmpfohlenErgänzt das Kurzformat um den Branch und die Voraus-/Zurück-Zähler

Beispiel

git status -sb

Fortgeschritten (1)

Gibt die Ausgabe in einem stabilen, leicht auswertbaren Format für Skripte aus. Es bleibt über Git-Versionen und Einstellungen hinweg gleich.

Bei BedarfStabiles, maschinenlesbares Format für Skripte

Beispiel

git status --porcelain

Die richtige Option wählen

Codes des Kurzformats

Die zwei Spalten von git status -s

BefehlBedeutung
?? fileUnverfolgt: Git kennt die Datei nicht
M fileGeändert, nicht vorgemerkt
M fileGeändert und vorgemerkt
MM fileVorgemerkt, dann erneut geändert
A fileNeue Datei, vorgemerkt
D fileGelöscht, nicht vorgemerkt

Beispiele

Vollständiger Status

git status

Listet vorgemerkte und nicht vorgemerkte Änderungen sowie unverfolgte Dateien, mit Hinweisen.

Kurzformat

git status -s

Eine Zeile pro Datei mit einem Zwei-Buchstaben-Code.

Kurz mit Branch

git status -sb

Kurzformat plus Branch und seine Voraus-/Zurück-Zähler.

Workflow-Beispiele

1
git status

Sehen, was sich geändert hat

2
git add app.js

Die gewünschte Datei stagen

3
git status

Prüfen, dass sie unter "Changes to be committed" steht

4
git commit -m "Add to cart"

Commit

Fehlerbehebung

Eine Datei erscheint nicht in git status

Ursache: Sie steht in .gitignore, oder sie hat sich nicht geändert

Prüfe mit git check-ignore -v <file>; unveränderte verfolgte Dateien werden nicht aufgelistet

git status ist in einem großen Repository langsam

Ursache: Git durchsucht jede Datei des Arbeitsverzeichnisses

Beschränke es auf einen Ordner: git status src/

Tipps & Stolperfallen

Best Practices

  • ✓Führe git status vor git add und vor git commit aus.
  • ✓Lies die Hinweise: git status zeigt den Befehl, der jeden Zustand rückgängig macht.
  • ✓Nutze git status -sb für eine kompakte Ansicht, die trotzdem den Branch zeigt.

Häufige Fehler

  • ✗Committen, ohne vorher git status zu prüfen, und dabei ungewollte Dateien aufnehmen.
  • ✗Glauben, eine unverfolgte Datei werde committet — sie muss zuerst hinzugefügt werden.
  • ✗" M" und "M " für dasselbe halten: die Spalte sagt, ob die Änderung vorgemerkt ist.

FAQ

A:

Nein. Es liest nur deine Dateien, den Staging-Bereich und den letzten Commit.

A:

Deine Dateien, der Staging-Bereich und der letzte Commit sind identisch: es gibt nichts zu committen.

A:

Du hast sie vorgemerkt und danach erneut bearbeitet. Der nächste Commit speichert die vorgemerkte Version.