Skip to main content

Installation und Konfiguration testen

Ziel: Installation und Grundeinstellungen zuverlässig prüfen

Nach der Installation von Git for Windows und der ersten Konfiguration sollte sichergestellt sein, dass:

  • Git in der gewünschten Shell erreichbar ist,
  • die installierte Version aktuell genug ist,
  • Name und E-Mail-Adresse korrekt gesetzt sind,
  • der Standard-Branch und Editor den Erwartungen entsprechen,
  • der Git Credential Manager verfügbar ist,
  • ein Test-Repository problemlos erstellt und verwendet werden kann.

Wichtig: Führe die Befehle möglichst in der Shell aus, die du später überwiegend nutzen möchtest – etwa Git Bash, PowerShell oder das integrierte Terminal von PhpStorm.

Git-Version prüfen

Öffne Git Bash, PowerShell oder Windows Terminal und führe aus:

git --version

Eine erfolgreiche Installation liefert etwa:

git version 2.47.1.windows.1

Die konkrete Versionsnummer kann abweichen. Entscheidend ist, dass der Befehl ohne Fehlermeldung ausgeführt wird.

Alternativ zeigt dieser Befehl ausführlichere Build-Informationen:

git version --build-options

Wenn git nicht gefunden wird

In PowerShell kann die Fehlermeldung ungefähr so aussehen:

git : Der Begriff "git" ist nicht als Name eines Cmdlet, einer Funktion,
einer Skriptdatei oder eines ausführbaren Programms erkannt.

Dann ist Git entweder nicht korrekt installiert oder sein Installationsordner fehlt in der Umgebungsvariable PATH.

Prüfe zunächst, ob Windows Git findet:

where.exe git

In Git Bash verwendest du stattdessen:

which git

Ein typisches Ergebnis unter Windows ist:

C:\Program Files\Git\cmd\git.exe

Falls kein Pfad erscheint:

  1. Schließe alle offenen Terminalfenster vollständig.
  2. Öffne ein neues Terminal.
  3. Führe git --version erneut aus.
  4. Installiere Git for Windows gegebenenfalls erneut und wähle bei der Installation die Option, Git über die Kommandozeile und Drittprogramme verfügbar zu machen.

Verwendete Git-Installation kontrollieren

Insbesondere auf Entwicklungsrechnern können mehrere Git-Installationen vorhanden sein, etwa über Git for Windows, eine IDE, WSL oder andere Entwicklerwerkzeuge.

Prüfe deshalb den tatsächlich verwendeten Pfad:

git --exec-path

Unter Git for Windows sieht das Ergebnis häufig ähnlich aus:

C:/Program Files/Git/mingw64/libexec/git-core

Zusätzlich kannst du den ausführbaren Befehl ermitteln:

Get-Command git

Beispielausgabe in PowerShell:

CommandType     Name      Version    Source
-----------     ----      -------    ------
Application     git.exe   2.47.1.1   C:\Program Files\Git\cmd\git.exe

Wenn PhpStorm später eine andere Git-Version verwendet als dein Terminal, solltest du dies in den IDE-Einstellungen korrigieren. Eine einheitliche Git-Installation verhindert schwer nachvollziehbare Unterschiede im Verhalten.

Globale Identität überprüfen

Jeder Commit enthält Informationen über die Person, die ihn erstellt hat. Prüfe daher die globale Konfiguration:

git config --global user.name
git config --global user.email

Beispiel:

Max Mustermann
max.mustermann@example.com

Die Werte müssen zu der Identität passen, mit der du auf GitHub arbeiten möchtest. Besonders die E-Mail-Adresse ist wichtig: GitHub kann Commits nur dann zuverlässig deinem Konto zuordnen, wenn die Commit-E-Mail-Adresse bei GitHub hinterlegt oder als GitHub-noreply-Adresse eingerichtet ist.

Falls ein Wert fehlt oder falsch ist, setze ihn neu:

git config --global user.name "Max Mustermann"
git config --global user.email "max.mustermann@example.com"

Vollständige Konfiguration anzeigen

Mit folgendem Befehl erhältst du alle wirksamen Konfigurationswerte:

git config --list

Für die Fehlersuche ist diese Variante besser geeignet:

git config --list --show-origin

Sie zeigt zusätzlich, aus welcher Datei ein Wert stammt:

file:C:/Users/max/.gitconfig    user.name=Max Mustermann
file:C:/Users/max/.gitconfig    user.email=max.mustermann@example.com
file:C:/Program Files/Git/etc/gitconfig    core.autocrlf=true

So erkennst du, ob eine Einstellung systemweit, global für dein Benutzerkonto oder nur für ein bestimmtes Repository gesetzt wurde.

Standard-Branch prüfen

Moderne Git-Repositories verwenden üblicherweise main als Anfangsbranch. Prüfe den eingestellten Standardwert:

git config --global init.defaultBranch

Das erwartete Ergebnis ist:

main

Falls keine Ausgabe erscheint, ist kein globaler Standard gesetzt. Lege ihn fest:

git config --global init.defaultBranch main

Diese Einstellung betrifft nur neu initialisierte Repositories. Bestehende Repositories werden dadurch nicht umbenannt.

Standard-Editor prüfen

Git öffnet bei bestimmten Aktionen einen Editor, etwa beim Schreiben einer Merge-Commit-Nachricht oder beim interaktiven Rebase. Unter Windows ist ein bewusst gewählter Editor wichtig, weil ein unerwartet gestarteter Konsoleneditor Einsteiger häufig verwirrt.

Prüfe zunächst, ob ein Editor konfiguriert ist:

git config --global core.editor

Mögliche Ausgaben sind:

notepad

oder:

code --wait

Für einen einfachen Einstieg ist Windows Editor geeignet:

git config --global core.editor notepad

Wenn Visual Studio Code installiert ist, ist diese Einstellung oft komfortabler:

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

Die Option --wait ist entscheidend: Git muss warten, bis die Editor-Datei geschlossen wird. Ohne diese Option kann Git die Aktion fortsetzen, bevor du die Commit-Nachricht fertig geschrieben hast.

Hinweis: PhpStorm kann für viele Git-Aktionen eigene Dialoge bereitstellen. Die Einstellung core.editor bleibt trotzdem relevant, wenn du Git direkt im Terminal verwendest.

Zeilenenden-Konfiguration kontrollieren

Windows verwendet traditionell Zeilenenden mit CRLF, während Linux und viele Serverumgebungen LF verwenden. Prüfe den gesetzten Wert:

git config --global core.autocrlf

Bei einer üblichen Windows-Konfiguration lautet die Ausgabe:

true

Falls du die im Kurs empfohlene Windows-Grundeinstellung verwenden möchtest:

git config --global core.autocrlf true

Die Bedeutung lautet:

  • Beim Auschecken werden Textdateien auf CRLF umgestellt.
  • Beim Commit werden sie wieder mit LF gespeichert.
  • Das Repository bleibt dadurch für andere Plattformen konsistent.

Später sorgen .gitattributes-Dateien für noch präzisere und projektweit verbindliche Regeln. Die globale Einstellung ist aber eine sinnvolle Ausgangsbasis.

Git Credential Manager testen

Git for Windows bringt normalerweise den Git Credential Manager mit. Er speichert und verwaltet Zugangsdaten für HTTPS-Verbindungen sicher über die Windows-Anmeldeinformationsverwaltung.

Prüfe die konfigurierte Credential-Hilfe:

git config --global credential.helper

Eine typische Ausgabe ist:

manager

Je nach Version kann auch Folgendes erscheinen:

manager-core

Prüfe zusätzlich, ob das Programm verfügbar ist:

git credential-manager --version

Beispiel:

2.6.1

Wenn der Befehl nicht gefunden wird, prüfe zunächst die Git-Installation erneut. Installiere nicht vorschnell einen separaten Credential Manager, denn bei aktuellen Git-for-Windows-Versionen gehört er normalerweise zum Installationsumfang.

Test-Repository anlegen

Eine erfolgreiche Versionsabfrage beweist nur, dass Git gestartet werden kann. Ein kleines Test-Repository bestätigt dagegen den vollständigen lokalen Workflow: Initialisierung, Staging, Commit und Historie.

Erstelle einen temporären Arbeitsordner:

mkdir C:\Projekte\git-test
cd C:\Projekte\git-test

In Git Bash wäre derselbe Pfad beispielsweise:

mkdir -p /c/Projekte/git-test
cd /c/Projekte/git-test

Initialisiere das Repository:

git init

Eine erwartbare Ausgabe sieht so aus:

Initialized empty Git repository in C:/Projekte/git-test/.git/

Prüfe den aktuellen Zustand:

git status

Bei einem leeren Repository erscheint ungefähr:

On branch main

No commits yet

nothing to commit

Der Ordner enthält nun ein verstecktes Verzeichnis namens .git. Darin speichert Git seine Historie, Einstellungen, Referenzen und Objekte.

Achtung: Lösche das Verzeichnis .git nicht. Damit würdest du die gesamte lokale Git-Historie und Repository-Konfiguration entfernen.

Ersten Test-Commit erstellen

Erstelle eine Datei:

"Git-Installation erfolgreich getestet." | Out-File -Encoding utf8 README.md

In Git Bash funktioniert beispielsweise:

echo "Git-Installation erfolgreich getestet." > README.md

Prüfe den Zustand:

git status

Git sollte die Datei als noch nicht verfolgt melden:

Untracked files:
  README.md

Füge sie zur Staging Area hinzu:

git add README.md

Prüfe den Zustand erneut:

git status

Jetzt sollte Git die Datei als für den Commit vorgemerkt anzeigen:

Changes to be committed:
  new file:   README.md

Erstelle den ersten Commit:

git commit -m "Initialen Test-Commit erstellen"

Eine erfolgreiche Ausgabe ähnelt diesem Beispiel:

[main abc1234] Initialen Test-Commit erstellen
 1 file changed, 1 insertion(+)
 create mode 100644 README.md

Der kurze Hash wie abc1234 ist nur ein Beispiel. Jeder Commit erhält eine eigene eindeutige Kennung.

Prüfe schließlich die Historie:

git log --oneline

Erwartetes Muster:

abc1234 Initialen Test-Commit erstellen

Und kontrolliere den sauberen Zustand:

git status

Die gewünschte Ausgabe lautet:

On branch main
nothing to commit, working tree clean

Damit ist die lokale Git-Installation einschließlich Benutzeridentität und Commit-Erstellung erfolgreich getestet. ✅

Kompakte Abschlussprüfung

Die folgende Befehlsfolge liefert einen schnellen Überblick:

git --version
git config --global user.name
git config --global user.email
git config --global init.defaultBranch
git config --global core.editor
git config --global core.autocrlf
git config --global credential.helper
git credential-manager --version

Zusätzlich sollte im Test-Repository Folgendes funktionieren:

git status
git log --oneline

Wenn alle Befehle ohne Fehler laufen, ist die lokale Umgebung für die nächsten Schritte bereit.

Typische Probleme und passende Lösungen

Symptom Wahrscheinliche Ursache Geeignete Maßnahme
git wird nicht erkannt Git fehlt im PATH oder das Terminal ist noch geöffnet Terminal neu starten, where.exe git prüfen, Git-Installation kontrollieren
Commit wird wegen unbekannter Identität abgelehnt user.name oder user.email fehlen Beide Werte mit git config --global setzen
Der erste Branch heißt master statt main init.defaultBranch war beim Initialisieren nicht gesetzt Für neue Repositories git config --global init.defaultBranch main setzen; bestehenden Branch bei Bedarf umbenennen
Git öffnet einen ungewohnten Editor Kein geeigneter core.editor gesetzt Beispielsweise git config --global core.editor notepad verwenden
GitHub fragt bei HTTPS ständig nach Zugangsdaten Credential Manager ist nicht eingerichtet oder nicht aktiv credential.helper prüfen und später die GitHub-Anmeldung erneut durchführen
Unerwartet viele Dateiänderungen nach einem Checkout Zeilenenden sind nicht einheitlich geregelt core.autocrlf prüfen; später .gitattributes im Projekt ergänzen

Aufräumen des Testprojekts

Das Test-Repository kann als Übungsprojekt erhalten bleiben. Wenn du es nicht mehr brauchst, lösche ausschließlich den Projektordner:

Remove-Item -Recurse -Force C:\Projekte\git-test

Oder in Git Bash:

rm -rf /c/Projekte/git-test

Verwende Löschbefehle immer bewusst: Remove-Item -Recurse -Force und rm -rf entfernen Ordner und Inhalte ohne Papierkorb.

Checkliste

  • git --version liefert eine Versionsnummer.
  • git ist in Git Bash, PowerShell oder Windows Terminal erreichbar.
  • user.name enthält den gewünschten Namen.
  • user.email enthält die passende Commit-E-Mail-Adresse.
  • init.defaultBranch ist auf main gesetzt.
  • Ein sinnvoller Git-Editor ist konfiguriert.
  • core.autocrlf ist bewusst festgelegt.
  • Der Git Credential Manager ist verfügbar.
  • Ein lokales Repository wurde erfolgreich initialisiert.
  • Ein Test-Commit erscheint in git log --oneline.
  • git status meldet nach dem Commit einen sauberen Arbeitsstand.

Im nächsten Kapitel wird PhpStorm mit dieser Git-Installation verbunden und als grafische Arbeitsumgebung für Commits, Diffs, Branches und GitHub vorbereitet.

Back to top