git config

Einrichtung & Projekte anlegen

Git-Einstellungen lesen und setzen

Der Befehl 'git config' liest und schreibt Einstellungen als Schlüssel = Wert-Paare. Ohne Bereich wirkt er auf das aktuelle Repository (.git/config); --global wirkt auf deine Benutzerdatei (~/.gitconfig) und gilt für jedes Repository auf deinem Rechner. Eine Repository-Einstellung hat Vorrang vor der globalen. Die ersten Einstellungen, die jeder braucht, sind user.name und user.email, die in jeden Commit geschrieben werden.

Syntax

git config [--global | --local] <key> [<value>]
git config [--global] --unset <key>
git config [--global] --list
[ ] optional| oder<arg> Platzhalter... wiederholbar--flag Option

Optionen

Klicke auf eine Option, um sie aufzuklappen

Einsteiger (3)

Liest oder schreibt deine Benutzereinstellungen (~/.gitconfig), die alle Repositorys teilen.

EmpfohlenIdentität und Vorlieben einmal für alle Projekte setzen

Beispiel

git config --global user.name "Ada Lovelace"

Entfernt eine Einstellung.

Bei BedarfEine Einstellung entfernen, um zum Standard zurückzukehren

Beispiel

git config --unset pull.rebase

Listet jede gültige Einstellung mit ihrem Wert.

Bei BedarfHerausfinden, welche Einstellungen gelten und woher sie kommen

Beispiel

git config --list --show-origin

Die richtige Option wählen

Wo Einstellungen liegen

Die spezifischste gewinnt

BefehlDateiGilt für
--system/etc/gitconfigAlle Benutzer des Rechners
--global~/.gitconfigAlle deine Repositorys
--local (default).git/configNur dieses Repository

Beispiele

Deinen Namen setzen

git config --global user.name "Ada Lovelace"

Wird in jedem Commit verwendet.

Deine E-Mail setzen

git config --global user.email ada@example.com

Wird ebenfalls in jedem Commit verwendet.

Eine Einstellung lesen

git config user.name

Gibt den hier gültigen Wert aus.

Name des Standard-Branches

git config --global init.defaultBranch main

git init startet dann auf main.

Workflow-Beispiele

1
git config --global user.name "Ada Lovelace"

Dein Name

2
git config --global user.email ada@example.com

Deine E-Mail

3
git config --global init.defaultBranch main

Neue Repositorys beginnen auf main

Fehlerbehebung

Author identity unknown

Ursache: user.name / user.email sind nicht gesetzt

Setze sie mit git config --global

Eine Einstellung scheint ignoriert zu werden

Ursache: Ein anderer Bereich überschreibt sie

git config --list --show-origin zeigt, woher jeder Wert stammt

Tipps & Stolperfallen

Best Practices

  • ✓Setze deine Identität global und überschreibe sie pro Repository nur bei Bedarf (z. B. eine Arbeits-E-Mail).
  • ✓Prüfe Einstellungen mit --show-origin, wenn sich etwas unerwartet verhält.

Häufige Fehler

  • ✗Committen, bevor user.name und user.email gesetzt sind.
  • ✗Eine Arbeits-E-Mail mit --global auf einem privaten Rechner setzen, oder umgekehrt.
  • ✗Probleme mit Anführungszeichen: Namen mit Leerzeichen brauchen Anführungszeichen.

FAQ

A:

~/.gitconfig (unter Windows: C:\Users\<you>\.gitconfig).

A:

git config --global core.editor "code --wait".