Commit-Nachrichten
Warum Commit-Nachrichten wichtig sind
Commit-Nachrichten sind entscheidend, um die Historie eines Projekts nachzuvollziehen. Klare und aussagekräftige Nachrichten helfen Mitarbeitenden, zukünftigen Entwicklern und Ihnen selbst, den Zweck und Kontext jeder Änderung zu verstehen. Eine gut strukturierte Commit-Historie verbessert die Zusammenarbeit, vereinfacht das Debugging und erleichtert das Nachverfolgen spezifischer Änderungen im Projektverlauf.
Aufbau einer guten Commit-Nachricht
1. Prägnanz und Klarheit
Eine Commit-Nachricht sollte prägnant und auf den Punkt gebracht sein. Sie sollte den Zweck des Commits klar in einer einzigen Zeile vermitteln. Mehrdeutigkeiten sind zu vermeiden; die Nachricht sollte genügend Informationen bieten, um die Änderung ohne Einsicht in den eigentlichen Code zu verstehen.
Bad: "Fixed a bug"
Good: "Fix issue with user authentication in login form"
2. Trennung von Betreff und Nachrichtentext
Wenn weitere Details erforderlich sind, den Betreff von dem Nachrichtentext der Commit-Nachricht durch eine Leerzeile trennen. Der Betreff sollte die Änderung zusammenfassen, während der Nachrichtentext zusätzlichen Kontext, Gründe für die Änderung und relevante Informationen liefern kann.
Hier ein Beispiel für eine solche Commit-Nachricht:
Subject: "Add validation for user email input"
Body: "This commit introduces email format validation to ensure
that users provide a valid email address when registering. It
helps improve the overall data integrity of the system."
In diesem Fall den Befehl git commit ohne das -m-Flag ausführen:
Der standardmäßige Texteditor für Git wird geöffnet, in dem eine ausführliche Commit-Nachricht verfasst werden kann. Anschließend sollte diese gespeichert und der Texteditor ordnungsgemäß beendet werden.
Nun wird ein weiterer Commit im Repository erstellt:
Hier ist der Befehl, um die Textdatei zu ändern:
Die Commit-Nachricht lautet wie folgt:
Wenn Sie die Datei nicht bearbeiten können, drücken Sie die i-Taste. Dadurch gelangen Sie in den Bearbeitungsmodus. Um Änderungen zu speichern und Vim zu verlassen, drücken Sie erneut die Escape-Taste und zweimal den Großbuchstaben Z.
Falls Sie einen anderen Standard-Texteditor im Terminal verwenden (nicht Vim) und auf Schwierigkeiten stoßen, finden Sie im Internet leicht Anleitungen zum Speichern und Beenden.
3. Verwendung des Imperativs
Commit-Nachrichten im Imperativ formulieren, um die Richtung der Änderung klar anzugeben. Beginnen Sie den Betreff mit einem Verb, wie zum Beispiel "Fix", "Add" oder "Update".
Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
Danke für Ihr Feedback!
Fragen Sie AI
Fragen Sie AI
Fragen Sie alles oder probieren Sie eine der vorgeschlagenen Fragen, um unser Gespräch zu beginnen
Awesome!
Completion rate improved to 3.57Commit-Nachrichten
Swipe um das Menü anzuzeigen
Warum Commit-Nachrichten wichtig sind
Commit-Nachrichten sind entscheidend, um die Historie eines Projekts nachzuvollziehen. Klare und aussagekräftige Nachrichten helfen Mitarbeitenden, zukünftigen Entwicklern und Ihnen selbst, den Zweck und Kontext jeder Änderung zu verstehen. Eine gut strukturierte Commit-Historie verbessert die Zusammenarbeit, vereinfacht das Debugging und erleichtert das Nachverfolgen spezifischer Änderungen im Projektverlauf.
Aufbau einer guten Commit-Nachricht
1. Prägnanz und Klarheit
Eine Commit-Nachricht sollte prägnant und auf den Punkt gebracht sein. Sie sollte den Zweck des Commits klar in einer einzigen Zeile vermitteln. Mehrdeutigkeiten sind zu vermeiden; die Nachricht sollte genügend Informationen bieten, um die Änderung ohne Einsicht in den eigentlichen Code zu verstehen.
Bad: "Fixed a bug"
Good: "Fix issue with user authentication in login form"
2. Trennung von Betreff und Nachrichtentext
Wenn weitere Details erforderlich sind, den Betreff von dem Nachrichtentext der Commit-Nachricht durch eine Leerzeile trennen. Der Betreff sollte die Änderung zusammenfassen, während der Nachrichtentext zusätzlichen Kontext, Gründe für die Änderung und relevante Informationen liefern kann.
Hier ein Beispiel für eine solche Commit-Nachricht:
Subject: "Add validation for user email input"
Body: "This commit introduces email format validation to ensure
that users provide a valid email address when registering. It
helps improve the overall data integrity of the system."
In diesem Fall den Befehl git commit ohne das -m-Flag ausführen:
Der standardmäßige Texteditor für Git wird geöffnet, in dem eine ausführliche Commit-Nachricht verfasst werden kann. Anschließend sollte diese gespeichert und der Texteditor ordnungsgemäß beendet werden.
Nun wird ein weiterer Commit im Repository erstellt:
Hier ist der Befehl, um die Textdatei zu ändern:
Die Commit-Nachricht lautet wie folgt:
Wenn Sie die Datei nicht bearbeiten können, drücken Sie die i-Taste. Dadurch gelangen Sie in den Bearbeitungsmodus. Um Änderungen zu speichern und Vim zu verlassen, drücken Sie erneut die Escape-Taste und zweimal den Großbuchstaben Z.
Falls Sie einen anderen Standard-Texteditor im Terminal verwenden (nicht Vim) und auf Schwierigkeiten stoßen, finden Sie im Internet leicht Anleitungen zum Speichern und Beenden.
3. Verwendung des Imperativs
Commit-Nachrichten im Imperativ formulieren, um die Richtung der Änderung klar anzugeben. Beginnen Sie den Betreff mit einem Verb, wie zum Beispiel "Fix", "Add" oder "Update".
Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
Danke für Ihr Feedback!
