Hilfe finden, wenn Git dich überrascht

Git wird irgendwann eine Meldung ausgeben, die du noch nicht gesehen hast. Das bedeutet nicht, dass du dir jede Meldung vorher merken solltest. Es ist ein Grund, einen verlässlichen Weg zu haben, um herauszufinden, was Git weiß und was ein Befehl bedeutet.

Beim Repository anfangen, nicht bei einer Vermutung

Wenn dich innerhalb eines Repositorys etwas überrascht, beginne mit git status. Du kennst diesen Befehl bereits: Er nennt den aktuellen Branch, meldet einen nicht abgeschlossenen Merge und unterscheidet zwischen Pfaden in der Staging-Area, Änderungen außerhalb der Staging-Area und nicht verfolgten Pfaden. Lies das gesamte Ergebnis, bevor du eine Reparatur wählst.

Eine Fehlermeldung enthält oft zwei Arten von Informationen. Der erste Teil sagt, was Git abgelehnt hat. Spätere Zeilen schlagen möglicherweise einen Befehl vor oder benennen einen Zustand, der zuerst bereinigt werden muss. Betrachte diese Zeilen als Hinweise, nicht als Aufforderung, jeden sichtbaren Befehl zu kopieren. Ein Vorschlag kann zu einer Absicht passen und für eine andere falsch sein.

Schreibe die Frage vor der Suche in gewöhnlichen Worten auf. „Auf welchem Branch bin ich?“ ist nützlicher als „Git kaputt“. „Wie wählt restore eine Quelle aus?“ ist nützlicher, als einen unerklärten Befehl einzufügen und zu hoffen, dass er passt.

Git nach dem Handbuch zu einem Befehl fragen

Git enthält Handbücher für seine Befehle. In git help <command> ist das Wort in spitzen Klammern ein Platzhalter: Ersetze <command> durch den Befehl, den du verstehen möchtest. Das folgende Beispiel fragt etwa nach dem Handbuch zu git status:

git help status

Je nach Computer öffnet Git das Handbuch in einem Terminalpager oder einem Webbrowser. Wenn es sich in einem Pager öffnet, drücke q, um zur Eingabeaufforderung zurückzukehren. Das Lesen eines Handbuchs verändert das Repository nicht.

Das Handbuch ist ein Nachschlagewerk, keine Lektion, die du von Anfang bis Ende lesen musst. Beginne mit der Beschreibung und suche dann nach der Option oder dem Begriff aus der Meldung, die du untersuchst. Höre auf, sobald du die Frage beantworten kannst, die dich dorthin geführt hat.

Die offizielle Webreferenz verwenden, wenn das einfacher ist

Die offizielle Git-Referenz stellt dieselbe Befehlsdokumentation auf einer durchsuchbaren Webseite bereit. Das ist nützlich, wenn dir das Anzeigeprogramm im Terminal fremd ist, du Verknüpfungen zwischen verwandten Begriffen brauchst oder auf einem anderen Gerät liest.

Versionsnummern spielen eine Rolle, wenn ein Handbuch ein Verhalten beschreibt, das dein installiertes Git nicht kennt. git --version zeigt deine Version an, und in der Webreferenz kannst du bei Bedarf ältere Dokumentation auswählen. Gehe nicht davon aus, dass ein beliebiges Beispiel und deine Installation gleich alt oder gleich konfiguriert sind.

Diese Gewohnheit zur Hilfesuche ist keine neue Prüfung und kein Befehl, den du für den Kurs ausführen musst. So arbeitest du nach dem Ende der vorbereiteten Übungen sicher weiter: Lies den Zustand, benenne die Frage, schlage in der passenden Referenz nach und nimm die kleinste Änderung vor, die du überprüfen kannst.