Git konfigurieren: Name und E-Mail-Adresse einrichten ⚙️
Bevor du deinen ersten Commit machst, solltest du Git mitteilen, wer du bist. Das klingt vielleicht nach einer Formalität, hat aber einen sehr konkreten Grund.
Warum ist diese Konfiguration wichtig?
Jeder Commit, den du in Git erstellst, wird mit einem Autor versehen – also mit einem Namen und einer E-Mail-Adresse. Diese Informationen werden dauerhaft in der Versionshistorie gespeichert und sind für jeden sichtbar, der Zugriff auf das Repository hat.
Das ist aus mehreren Gründen relevant:
- Nachvollziehbarkeit: In einem Projekt (egal ob allein oder im Team) kannst du später genau sehen, wer eine bestimmte Änderung gemacht hat. Das hilft beim Debugging und bei der Zusammenarbeit enorm.
- Zuordnung auf Plattformen wie GitHub: Wenn deine konfigurierte E-Mail-Adresse mit deinem GitHub-Konto verknüpft ist, werden deine Commits automatisch deinem Profil zugeordnet – inklusive Profilbild und Verlinkung.
- Professionalität: Commits mit „Unknown" oder einer kryptischen Kennung wirken unprofessionell und erschweren die Zusammenarbeit.
So richtest du Name und E-Mail ein
Öffne ein Terminal (unter Windows z. B. Git Bash, PowerShell oder CMD; unter macOS/Linux das normale Terminal) und führe diese beiden Befehle aus:
git config --global user.name "Dein Name"
git config --global user.email "deine.email@beispiel.de"
Ersetze dabei natürlich die Platzhalter durch deine echten Daten. Ein konkretes Beispiel:
git config --global user.name "Max Mustermann"
git config --global user.email "max.mustermann@gmail.com"
💡 Hinweis zur E-Mail: Verwende am besten dieselbe E-Mail-Adresse, die du auch bei GitHub (oder einer anderen Plattform) nutzt. So werden deine Commits korrekt zugeordnet.
Was bedeutet --global?
Die Option --global sorgt dafür, dass diese Einstellungen für alle Git-Repositories auf deinem Computer gelten. Die Konfiguration wird in einer Datei namens .gitconfig in deinem Benutzerverzeichnis gespeichert.
Falls du für ein einzelnes Projekt andere Daten verwenden möchtest (z. B. eine Firmen-E-Mail für berufliche Projekte), kannst du die Konfiguration ohne --global im jeweiligen Repository-Ordner ausführen:
git config user.name "Firmenname Max"
git config user.email "max@firma.de"
Diese lokale Einstellung überschreibt dann die globale – aber nur für dieses eine Repository.
Überprüfen, ob die Konfiguration funktioniert hat
Mit diesen Befehlen kannst du dir anzeigen lassen, was Git aktuell gespeichert hat:
git config --global user.name
git config --global user.email
Die Ausgabe sollte dann entsprechend dein Name und deine E-Mail sein. Alternativ kannst du dir alle globalen Einstellungen auf einmal anzeigen lassen:
git config --global --list
Was passiert, wenn du das nicht konfigurierst? 🚨
Wenn du versuchst, einen Commit zu erstellen, ohne Name und E-Mail konfiguriert zu haben, passiert Folgendes:
-
Git verweigert den Commit und zeigt eine Fehlermeldung wie diese:
Author identity unknown *** Please tell me who you are. Run git config --global user.email "you@example.com" git config --global user.name "Your Name" -
Kein Commit wird erstellt, bis du die Konfiguration nachholst.
Das ist also kein stilles Problem, das später Ärger macht – Git zwingt dich förmlich dazu, diese Angaben zu machen, bevor du loslegst. Trotzdem ist es besser, das einmal sauber am Anfang zu erledigen, als bei jedem neuen Projekt darüber zu stolpern.
Zusammenfassung 📋
| Befehl | Wirkung |
|---|---|
git config --global user.name "Name" |
Setzt deinen Namen für alle Repos |
git config --global user.email "email" |
Setzt deine E-Mail für alle Repos |
git config --global --list |
Zeigt alle globalen Einstellungen |
git config user.name (ohne --global) |
Setzt den Namen nur für das aktuelle Repo |
Nach dieser einmaligen Konfiguration bist du bereit für deinen ersten Commit! 🎉