Dein erster Commit in PhpStorm – Schritt für Schritt 🎉

Du hast dein Projekt als Git-Repository initialisiert und möglicherweise schon eine 
.gitignore-Datei angelegt. Jetzt wird es Zeit, deinen ersten Commit zu machen – also einen Schnappschuss deines aktuellen Projektstands in der Git-Historie zu speichern.
Der Ablauf im Überblick
Bevor wir in die Details gehen, hier der grundsätzliche Prozess:
flowchart LR
    A["1. Dateien bearbeiten\nim Working Directory"] --> B["2. Dateien zur\nStaging Area hinzufuegen"]
    B --> C["3. Commit erstellen\nmit Nachricht"]
    C --> D["4. Aenderung ist\nin der Historie"]
In PhpStorm ist dieser Prozess besonders komfortabel, weil du alles in einer einzigen Oberfläche erledigen kannst.
Schritt-für-Schritt-Anleitung
Das Commit-Fenster öffnen
Es gibt mehrere Wege, das Commit-Fenster zu öffnen:
Tastenkürzel: 
Strg + K (Windows/Linux) bzw. 
Cmd + K (macOS) – der schnellste Weg
Menü: Gehe zu Git → Commit…
Toolbar: Klicke auf das grüne Häkchen-Symbol in der oberen Symbolleiste
Es öffnet sich links (oder als separates Fenster, je nach Einstellung) das Commit-Tool-Window.
Dateien für den Commit auswählen
Im Commit-Fenster siehst du eine Liste aller Dateien, die sich seit dem letzten Commit geändert haben. Diese sind in Kategorien unterteilt:
Unversioned Files: Neue Dateien, die Git noch nicht kennt (rot markiert)
Modified Files: Bereits getrackte Dateien, die du verändert hast (blau markiert)
Deleted Files: Dateien, die gelöscht wurden
💡 Tipp: Bei deinem allerersten Commit werden alle Dateien als „Unversioned" angezeigt, weil Git sie noch nie gesehen hat.
So wählst du Dateien aus:
Setze ein Häkchen vor jede Datei, die du in diesen Commit aufnehmen möchtest
Um alle Dateien auszuwählen, klicke auf das Häkchen ganz oben bei „Changes" oder „Unversioned Files"
Du kannst auch einzelne Dateien gezielt ein- oder ausschließen
PhpStorm zeigt dir bei jeder Datei eine Vorschau der Änderungen (Diff), wenn du sie anklickst. So kannst du nochmal prüfen, was genau du committen wirst.
Eine aussagekräftige Commit-Nachricht schreiben
Unterhalb der Dateiliste findest du ein Textfeld mit dem Platzhalter „Commit Message". Hier beschreibst du, was du geändert hast und warum.
Für deinen ersten Commit ist eine einfache Nachricht völlig in Ordnung, zum Beispiel:
Initial commit: Projektstruktur angelegt
oder etwas ausführlicher:
Erstes Commit: Grundlegende PHP-Dateien und Konfiguration hinzugefügt
📝 Best Practice: Schreibe die Nachricht so, dass du (oder andere) in drei Monaten noch verstehst, was dieser Commit enthält. Mehr dazu später im Kurs bei den Best Practices.
Optionale Einstellungen prüfen
Unter dem Nachrichtenfeld findest du einige Optionen, die du für den Anfang meist ignorieren kannst:
Amend commit: Fügt Änderungen zum letzten Commit hinzu (für Anfänger erstmal nicht relevant)
Author: Zeigt deinen konfigurierten Namen und E-Mail – sollte bereits korrekt sein
Before Commit: Hier kannst du automatische Prüfungen aktivieren (z. B. Code-Analyse, Reformatierung)
Für deinen ersten Commit kannst du diese Optionen auf den Standardeinstellungen belassen.
Den Commit abschließen
Wenn du mit deiner Dateiauswahl und Nachricht zufrieden bist, klicke auf den Commit-Button unten im Fenster.
⚠️ Hinweis: Du siehst möglicherweise auch einen Button „Commit and Push". Dieser würde den Commit direkt auf einen Remote-Server (z. B. GitHub) hochladen. Da du noch kein Remote-Repository eingerichtet hast, wähle zunächst nur „Commit".
PhpStorm zeigt dir kurz eine Bestätigung an, z. B.:
1 file committed: Initial commit: Projektstruktur angelegt
Nach dem Commit: Überprüfen, ob alles geklappt hat
Um sicherzugehen, dass dein Commit erfolgreich war, kannst du die Git-Historie in PhpStorm öffnen:
Gehe zu Git → Show Git Log (oder klicke unten auf den Tab „Git" und dann auf „Log")
Du siehst jetzt eine Liste aller Commits – bei deinem ersten Commit natürlich nur einen einzigen Eintrag
Klickst du auf den Commit, zeigt dir PhpStorm an, welche Dateien enthalten sind und was geändert wurde
Zusammenfassung des Prozesses
Schritt
Aktion
Tastenkürzel
Commit-Fenster öffnen
Git → Commit…
Strg/Cmd + K
Dateien auswählen
Häkchen setzen
–
Nachricht schreiben
Im Textfeld eingeben
–
Commit abschließen
Auf „Commit" klicken
–
Historie prüfen
Git → Show Git Log
Alt + 9
Was passiert eigentlich im Hintergrund? 🔍
Wenn du in PhpStorm auf „Commit" klickst, führt PhpStorm im Hintergrund zwei Git-Befehle aus:
git add <ausgewählte-dateien>
git commit -m "Deine Commit-Nachricht"
Der erste Befehl verschiebt die Dateien in die Staging Area, der zweite erstellt den eigentlichen Commit im Repository. PhpStorm fasst diese beiden Schritte für dich zusammen, sodass du sie nicht einzeln ausführen musst – aber es ist gut zu wissen, was „unter der Haube" passiert.
Du hast jetzt deinen ersten Commit erstellt! 🎊 Ab jetzt kannst du jederzeit weitere Änderungen machen und neue Commits erstellen – und dabei immer auf frühere Versionen zurückgreifen, falls nötig.