Mikor és hogyan kell átírni a Git történetet?

Question

Accepted Answer

A Git lehetővé teszi a **történet átírását** — commitok módosítása, rebase-elése, squash-olása vagy törlése —, hogy tisztázza a commitokat vagy problémákat javítson. Ez hatékony, de óvatosan kell kezelni: a **megosztott** történet átírása komoly problémákat okoz, ezért az ezzel kapcsolatos szabályok kritikusak. ## A történet átírásának módjai ```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). ``` ## Az arany szabály ```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. ``` ## A történet átírásának legitim felhasználása (helyi) ```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) ``` ## Ha a megosztott történetet kell átírni (ritka) ```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. ``` ## Miért számít A Git történetének átírásáról való tudás fontos senior szintű ismeret, mivel a történet átírása **erős, de veszélyes**, és a szabályok megértése — különösen a megosztott történetre vonatkozóan — megelőzi a komoly problémákat, miközben lehetővé teszi a legitim tisztázást. Az **átírási módok** ismerete (amend az utolsó commithoz, interaktív rebase squash/rewording/reordering-hoz, rebase lineáris történethez, reset, filter-repo nagyobb méretű változásokhoz) és annak tudása, hogy ezek mind **commit hash-eket módosítanak** (új commitokat hoznak létre), az alapot képezi. A legfontosabb az **arany szabály megértése — soha ne írjuk át a megosztott/push-olt történetet** —, mivel az átírás megváltoztatja a hash-eket, ami miatt az olyan története eltér a munkatársaitól (akiknek még az eredeti commitok vannak), ami duplikátumokhoz, konfliktusokhoz és fájdalmas rendezéshez vezet; az átírás egy komoly zavar, amit ez a szabály megelőz, a **revert** (biztonságos új visszavonási commit) helyette a helyes megközelítés megosztott ágakra vonatkozóan. A **legitim helyi felhasználások** megértése (WIP commitok tisztázása egy PR előtt, hibák javítása push előtt, rebase a linearitás megtartásához a megosztás előtt — mindez helyi, push-olatlan commitokon) tisztázza, hogy az átírás mikor alkalmazható és értékes. Egy kritikus biztonsági árnyalat: ha egy **titok commitokoztak és push-olták**, az átírás ennek eltávolítása érdekében nem elegendő — a titok már felfedésre került és **el kell forgatni** (ez egy fontos valós biztonsági pont). Annak tudása, hogy hogyan **kezelni a megosztott történet ritka szükséges átírását** (csapat koordináció, `--force-with-lease` helyett `--force`, mindenkinek újra szinkronizálnia kell) érett ítéletet tükröz. Mivel a történet átírása erős, de komoly problémákat okoz, ha rosszul alkalmazzák a megosztott történetre, és mivel az arany szabály, a legitim felhasználások és a biztonságos gyakorlatok megértése elengedhetetlen a felelős használathoz, a Git történetének átírásáról való tudás fontos senior szintű ismeret — egy olyan téma, ahol a biztonsági szabályok megértése (különösen soha ne írjuk át a megosztott történetet) megelőzi a valós együttműködési katasztrófákat, tükrözve a senior szerepkörökre várt ítéletet, akik csapatban dolgoznak a Gittel.