Einführung

Git wird mit umfangreicher integrierter Dokumentation ausgeliefert. Zu wissen, wie man sie schnell aufruft, spart Stunden des Ratens. Diese Seite führt durch das Hilfesystem von Einzeilern bis zu vollständigen Handbüchern.

Drei Wege zu fragen

Jeder Befehl unterstützt drei Hilfeformen:

git help <command>     # vollständige Manpage in Ihrem Pager
git <command> --help    # dasselbe
git <command> -h        # kurze Verwendungsübersicht

Beispiel:

git help commit
git commit --help
git commit -h

Befehle auflisten

git help -a            # alle Befehle
git help -g            # Anleitungen (gittutorial, gitcore-tutorial usw.)
git help everyday      # der alltägliche Git-Spickzettel

git help everyday ist insbesondere eine der besten Anfänger-bis-Mittelstufe-Referenzen, die mit Git ausgeliefert werden.

Konzeptanleitungen

Git enthält Prosa-Anleitungen als separate Manpages:

git help gittutorial
git help gitcore-tutorial
git help gitglossary
git help gitworkflows
git help gitrevisions

gitrevisions ist die kanonische Referenz für Ref-Syntax (HEAD~3, main@{yesterday} usw.).

Das Hilfeformat konfigurieren

Standardmäßig öffnet git help eine Manpage. Sie können auf HTML oder Info umstellen:

git config --global help.format html
git config --global help.format info
git config --global help.format man   # Standard

HTML öffnet die lokale Kopie in Ihrem Browser, nützlich auf Systemen ohne man.

Online-Ressourcen

• git-scm.com/docs: offizielles Handbuch, online gespiegelt.
• Pro Git Buch von Chacon und Straub: kostenlos, umfassend, regelmäßig aktualisiert.
• Archiv der Git-Mailingliste: lore.kernel.org/git für Designdiskussionen.

Dokumentation durchsuchen

Wenn Sie sich an einen Befehlsnamen nicht erinnern, listet man -k git (oder apropos git) jede Git-Manpage mit einer Einzeilenbeschreibung auf. Um innerhalb der Dokumente zu suchen, leiten Sie an grep weiter:

man -k git
git help -a | grep -i merge
git help log | grep -A 2 'pickaxe'

Für vertieftes Lernen ist das Pro Git Buch kostenlos und maßgeblich; das Git Reference Manual auf git-scm.com/docs spiegelt die Manpages mit Querverweisen. Die gitfaq-Manpage ist ein unterschätztes Juwel, das viele reale Fragen in klarer Prosa beantwortet.

Häufige Fehler

Im Web nach veralteten Stack-Overflow-Antworten mit deprecated Befehlen wie git checkout für das Wechseln von Branches suchen, obwohl git switch existiert. Gleichen Sie immer mit git help für Ihre installierte Version ab. Ein weiterer Fehler ist die Annahme, dass -h und --help sich gleich verhalten; das tun sie nicht. -h gibt eine Einbildschirm-Zusammenfassung aus, während --help die vollständige Manpage öffnet (oder den Browser, abhängig von help.format). Überspringen Sie schließlich nicht git help glossary; viele "seltsame" Git-Begriffe (Porcelain, Plumbing, Refspec, Dangling Object) sind dort präzise auf einer einzelnen kurzen Seite definiert.