Wann und wie solltest du Git-Verlauf umschreiben?

Question

Accepted Answer

Git ermöglicht es dir, **Verlauf umzuschreiben** — Commits zu ändern, zu rebasen, zu quetschen oder zu entfernen — um Commits zu bereinigen oder Probleme zu beheben. Es ist mächtig, muss aber sorgfältig durchgeführt werden: Das Umschreiben von **gemeinsamen** Verläufen verursacht ernsthafte Probleme, daher sind die Regeln dazu kritisch. ## Wege zum Umschreiben von Verlauf ```text git commit --amend → modify the most recent commit (message or content) git rebase -i → squash, reword, reorder, edit, drop commits (interactive) git rebase → replay commits onto another base (linear history) git reset → move the branch pointer (discard/uncommit) git filter-repo → rewrite MANY commits (remove a file/secret from all history) → All of these change commit HASHES (rewriting = creating new, different commits). ``` ## Die goldene Regel ```text ⚠️ NEVER rewrite history that has been PUSHED/SHARED (that others may have): → rewriting changes commit hashes → your history DIVERGES from collaborators' → they'll have the old commits; pulls create duplicates/conflicts; chaos ensues → forces everyone to painfully reconcile → a serious disruption ✓ Rewrite ONLY local, unpushed commits (cleanup before sharing). ✗ On shared branches → use REVERT (a new undoing commit) instead, which is safe. ``` ## Legitime Verwendungen des Umschreibens (lokal) ```text ✓ Clean up messy WIP commits before opening a PR (squash, reword) → clean history ✓ Fix a mistake in the last commit (amend) before pushing ✓ Keep a feature branch linear/up-to-date with main (rebase) before sharing ✓ Remove a SECRET accidentally committed (filter-repo) — though if it was PUSHED, the secret must be ROTATED (it's already exposed; rewriting alone isn't enough) ``` ## Wenn du gemeinsamen Verlauf umschreiben musst (selten) ```text → COORDINATE with the whole team (everyone stops, re-syncs) → Force-push carefully: git push --force-with-lease (safer than --force — checks first) → Everyone must reset/re-clone to the rewritten history → Do this only when truly necessary (e.g. purging a leaked secret) and with agreement. ``` ## Warum es wichtig ist Das Verständnis für wann und wie man Git-Verlauf umschreibt ist wichtiges Wissen auf Senior-Niveau, da das Umschreiben von Verlauf **mächtig aber gefährlich** ist, und das Verständnis der Regeln — besonders bezüglich gemeinsamen Verlaufs — ernsthafte Probleme verhindert und gleichzeitig legitime Bereinigung ermöglicht. Die **Wege zum Umschreiben** zu kennen (amend für den letzten Commit, interaktives Rebase für Quetschen/Umformulieren/Neuordnen, Rebase für lineare Historie, reset, filter-repo für großflächige Änderungen) und dass sie alle **Commit-Hashes ändern** (neue Commits erstellen) ist die Grundlage. Am kritischsten ist das Verständnis der **goldenen Regel — nie gemeinsamen/gepushten Verlauf umschreiben** — essentiell, denn Umschreiben ändert Hashes und verursacht, dass dein Verlauf von dem deiner Mitarbeiter divergiert (die noch die alten Commits haben), was zu Duplikaten, Konflikten und schmerzhafter Abstimmung führt; Umschreiben von gemeinsamen Verläufen ist eine ernsthafte Störung, die diese Regel verhindert, wobei **revert** (ein sicherer neuer Undo-Commit) der richtige Ansatz für gemeinsame Branches ist. Das Verständnis der **legitimen lokalen Verwendungen** (WIP-Commits vor einem PR bereinigen, Fehler vor dem Push ändern, Rebase durchführen um linear zu bleiben vor dem Teilen — alles auf lokalen, nicht gepushten Commits) verdeutlicht, wann Umschreiben angemessen und wertvoll ist. Eine wichtige Sicherheitsnuance: wenn ein **Geheimnis committed und gepusht wurde**, ist das Umschreiben des Verlaufs um es zu entfernen unzureichend — das Geheimnis ist bereits offengelegt und muss **rotiert** werden (ein wichtiger realer Sicherheitspunkt). Zu wissen, wie man die **seltene notwendige Umschreibung von gemeinsamen Verläufen handhabt** (Team-Koordination, `--force-with-lease` statt `--force`, alle re-synchen) zeigt ausgereiftes Urteilsvermögen. Da das Umschreiben von Verlauf mächtig ist, aber ernsthafte Probleme verursacht wenn es bei gemeinsamen Verläufen missbraucht wird, und da das Verständnis der goldenen Regel, legitimen Verwendungen und sicheren Praktiken essentiell ist um es verantwortungsvoll zu nutzen, ist das Verständnis für wann und wie man Git-Verlauf umschreibt wichtiges Senior-Niveau-Wissen — ein Thema wo das Verständnis der Sicherheitsregeln (besonders nie gemeinsamen Verlauf umschreiben) echte Zusammenarbeitsdisaster verhindert und das Urteilsvermögen widerspiegelt das für Senior-Rollen bei der Arbeit mit Git in Teams erwartet wird.