Übersicht

git config [--global | --system | --local] <key> [<value>]
git config --list
git config --edit

Beschreibung

Der git config-Befehl liest und schreibt die Git-Konfiguration. Einstellungen leben in drei Schichten: systemweit (/etc/gitconfig), pro Nutzer (~/.gitconfig oder ~/.config/git/config) und pro Repository (.git/config). Spezifischere Schichten überschreiben allgemeinere. Viele Git-Verhaltensweisen — Standardeditor, Push-Verhalten, Merge-Tools, Zeilenenden-Behandlung — werden über config eingestellt.

Für neue Nutzer sind die Essentials user.name, user.email, init.defaultBranch und core.editor. Power-User bauen umfangreiche Aliase, passen Farben an und verwenden Conditional Includes, um pro Projektverzeichnis unterschiedliche Einstellungen anzuwenden.

Im täglichen Einsatz integriert sich git config eng mit Shell-Aliasen, Editor-Plugins und Continuous Integration. Power-User fügen oft Aliase hinzu, die Flags kombinieren, die sie immer übergeben, oder wickeln den Befehl in Skripte, die Teamkonventionen durchsetzen. Die Ausgabeformatierung kann über Git-Config angepasst werden — Pretty-Formate, Farbschemata und Pager-Verhalten sind alle einstellbar. Wenn etwas schiefgeht, ist der erste Diagnoseschritt üblicherweise, den Befehl erneut mit GIT_TRACE=1 in der Umgebung auszuführen, was die zugrunde liegenden Plumbing-Aufrufe offenlegt. Für ungewöhnliche Situationen öffnet die --help-Ausgabe (git config --help) die vollständige Manpage mit Details zu jeder Option, einschließlich solcher, die in alltäglichen Workflows selten verwendet werden, aber für Debugging oder Skripting im großen Maßstab essentiell sind.

Zu verstehen, wie git config mit dem Rest von Gits Datenmodell interagiert — der Objektdatenbank, dem Index, Refs und dem Working Tree — zahlt sich aus. Jeder Befehl operiert auf einer Teilmenge dieser Stücke, und zu wissen, welche er berührt, hilft Ergebnisse vorherzusagen und sich von Fehlern zu erholen. Das Lesen der offiziellen Git-Dokumentation neben praktischer Übung in einem Wegwerf-Repository ist der schnellste Weg, die Nuancen zu verinnerlichen. Die meisten Produktionsprobleme mit Git rühren von einer von drei Ursachen: überraschendem Standardverhalten, partiellen Netzwerkoperationen oder dem Umschreiben bereits geteilter Historie. Ein funktionierendes mentales Modell der Nebenwirkungen von git config hilft, alle drei zu vermeiden.

Häufige Optionen

Option	Beschreibung
--global	Operiert auf der Pro-Nutzer-Konfiguration.
--system	Operiert auf der systemweiten Konfiguration.
--local	Operiert auf der Konfiguration des aktuellen Repos (Standard, falls in einem Repo).
--list	Zeigt alle Einstellungen.
--edit	Öffnet die gewählte Konfiguration in Ihrem Editor.
--unset	Entfernt eine Einstellung.
--add	Fügt einen Wert zu einem Multi-Value-Schlüssel hinzu.
--show-origin	Annotiert Ausgabe mit der Datei jeder Einstellung.

Beispiele

git config --global user.name "Jane Smith"
    git config --global user.email "[email protected]"
    # Identität für jedes Repo

    git config --global init.defaultBranch main
    git config --global pull.rebase true
    git config --global core.editor "code --wait"
    # Sinnvolle moderne Voreinstellungen

    git config --global alias.lg "log --oneline --graph --decorate --all"
    # Eigener Alias

    git config --list --show-origin
    # Audit, woher jede Einstellung stammt

Häufige Fehler

Globale Konfiguration zu setzen, die als lokal gemeint ist (oder umgekehrt), führt zu verwirrendem Verhalten. Vergessen, user.email auf einer frischen Maschine zu setzen, lässt jeden Commit ohne Zuordnung. Verwenden Sie Conditional Includes ([includeIf "gitdir:~/work/"]), um Identitäten pro Verzeichnis zu wechseln.

Verwandte Befehle

git credential, git init, git remote