Bila dan bagaimana anda patut menulis semula sejarah Git?

Question

Accepted Answer

Git membolehkan anda **menulis semula sejarah** — meminda (amend), rebase, squash, atau membuang commit — untuk membersihkan commit atau membaiki masalah. Ia berkuasa tetapi mesti dilakukan dengan berhati-hati: menulis semula sejarah yang **dikongsi** menyebabkan masalah serius, jadi peraturan di sekelilingnya adalah kritikal. ## Cara menulis semula sejarah ```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). ``` ## Peraturan emas ```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. ``` ## Penggunaan sah penulisan semula (setempat) ```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) ``` ## Jika anda terpaksa menulis semula sejarah yang dikongsi (jarang) ```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. ``` ## Mengapa ia penting Memahami bila dan bagaimana menulis semula sejarah Git ialah pengetahuan peringkat senior yang penting kerana penulisan semula sejarah adalah **berkuasa tetapi berbahaya**, dan memahami peraturannya — terutamanya berkenaan sejarah yang dikongsi — mencegah masalah serius sambil membenarkan pembersihan yang sah. Mengetahui **cara menulis semula** (amend untuk commit terakhir, rebase interaktif untuk squash/reword/reorder, rebase untuk sejarah linear, reset, filter-repo untuk perubahan skala besar) dan bahawa kesemuanya **mengubah hash commit** (mencipta commit baharu) ialah asasnya. Yang paling kritikal, memahami **peraturan emas — jangan sekali-kali menulis semula sejarah yang dikongsi/ditolak** — adalah penting kerana penulisan semula mengubah hash, menyebabkan sejarah anda berbeza daripada rakan sekerja (yang masih mempunyai commit lama), membawa kepada pendua, konflik, dan rekonsiliasi yang menyakitkan; menulis semula sejarah yang dikongsi ialah gangguan serius yang dicegah oleh peraturan ini, dengan **revert** (commit pembatalan baharu yang selamat) menjadi pendekatan yang betul untuk cawangan yang dikongsi sebaliknya. Memahami **penggunaan setempat yang sah** (membersihkan commit WIP sebelum PR, meminda kesilapan sebelum menolak, rebase untuk kekal linear sebelum berkongsi — kesemuanya pada commit setempat yang belum ditolak) menjelaskan bila penulisan semula adalah sesuai dan bernilai. Satu nuansa keselamatan yang penting: jika **rahsia telah di-commit dan ditolak**, menulis semula sejarah untuk membuangnya tidak mencukupi — rahsia tersebut sudah terdedah dan mesti **diputar (rotated)** (satu perkara keselamatan dunia sebenar yang penting). Mengetahui cara **mengendalikan penulisan semula sejarah yang dikongsi yang jarang diperlukan** (penyelarasan pasukan, `--force-with-lease` berbanding `--force`, semua orang menyegerak semula) mencerminkan pertimbangan yang matang. Memandangkan penulisan semula sejarah adalah berkuasa tetapi menyebabkan masalah serius apabila disalahgunakan pada sejarah yang dikongsi, dan memandangkan memahami peraturan emas, penggunaan yang sah, dan amalan selamat adalah penting untuk menggunakannya secara bertanggungjawab, memahami bila dan bagaimana menulis semula sejarah Git ialah pengetahuan peringkat senior yang penting — satu topik di mana memahami peraturan keselamatan (terutamanya jangan sekali-kali menulis semula sejarah yang dikongsi) mencegah bencana kolaborasi sebenar, mencerminkan pertimbangan yang dijangka untuk peranan senior yang bekerja dengan Git dalam pasukan.