7.6 Orodja Git - Prepisovanje zgodovine

Spreminjanje vaše zadnje potrditve je verjetno najpogostejše prepisovanje zgodovine, ki ga boste naredili. Pogosto boste želeli narediti dve osnovni stvari na svoji zadnji potrditvi: preprosto spremeniti sporočilo potrditve, ali pa spremeniti njeno dejansko vsebino z dodajanjem, odstranjevanjem in spreminjanjem datotek.

Če želite preprosto spremeniti sporočilo zadnje potrditve, je to precej enostavno:

Zgoraj navedeni ukaz naloži sporočilo prejšnje potrditve v sejo urejevalnika, kjer lahko spremenite sporočilo, shranite spremembe in izstopite. Ko shranite in zaprete urejevalnik, se ustvari nova potrditev s posodobljenim sporočilom in postane vaša nova zadnja potrditev.

Če pa želite spremeniti dejansko vsebino zadnje potrditve, postopek deluje na enak način — najprej naredite spremembe, ki ste jih pozabili, shranite te spremembe in nato z uporabo ukaza git commit --amend zamenjate zadnjo potrditev z vašo novo in izboljšano potrditvijo.

Pri tej tehniki morate biti previdni, saj spremeni vrednost SHA-1 potrditve. Gre za zelo majhno ponovno baziranje — ne spreminjajte zadnje potrditve, če ste jo že potisnili.

Če želite spremeniti potrditev, ki je dlje nazaj v zgodovini, morate uporabiti bolj zapletena orodja. Git nima orodja za spreminjanje zgodovine, vendar lahko uporabite orodje ponovnega baziranja, da na novo nanesete serijo potrditev na HEAD, na kateri so bile prvotno zasnovane, namesto da jih premikate na drugo glavo. Z interaktivnim orodjem ponovnega baziranja se lahko nato ustavite po vsaki potrditvi, ki jo želite spremeniti, in spremenite sporočilo, dodate datoteke, ali karkoli drugega želite narediti tam. Ponovno baziranje lahko poganjate interaktivno tako, da dodate ukazu git rebase možnost -i. Morali boste navesti, kako daleč nazaj želite preoblikovati potrditve, tako da ukazu poveste, na katero potrditev naj se ponovno baziranje izvaja.

Na primer, če želite spremeniti zadnja tri sporočila potrditev, ali katero koli sporočilo v tej skupini, argumentu git rebase -i podate nadrejeno zadnje potrditve, ki jo želite urediti, kar je HEAD~2^ ali HEAD~3. Lahko si zapomnite ~3, ker poskušate urediti zadnje tri potrditve, vendar imejte v mislih, da dejansko določate štiri potrditve nazaj, nadrejeno zadnje potrditve, ki jo želite urediti:

Ponovno poudarjamo, da gre za ukaz ponovnega baziranja — vsaka potrditev v območju HEAD~3..HEAD s spremenjenim sporočilom in vsi njeni potomci bodo preoblikovani. Ne vključite nobene potrditve, ki ste jo že potisnili na osrednji strežnik — to bo druge razvijalce zmedlo z zagotavljanjem alternativne različice iste spremembe.

Zagon tega ukaza vam da seznam potrditev v urejevalniku besedil, ki je videti nekako takole:

Pomembno je opozoriti, da so te potrditve navedene v obratnem vrstnem redu, kot jih običajno vidite z uporabo ukaza log. Če zaženete log, boste videli nekaj takega:

Opazite obratni vrstni red. Interaktivno ponovno baziranje vam da skript, ki ga bo izvedel. Začelo se bo pri potrditvi, ki jo določite v ukazni vrstici (HEAD~3) in bo od vrha navzdol ponovilo spremembe, uvedene v vsaki od teh potrditev. Najstarejšo potrditev na seznamu postavi na vrh, namesto najnovejše, ker jo bo najprej ponovilo.

Skript morate urediti, da se ustavi pri potrditvi, ki jo želite urediti. Da bi to naredili, spremenite besedo pick v besedo edit za vsako potrditev, za katero želite, da se skript ustavi po njej. Na primer, če želite spremeniti samo sporočilo tretje potrditve, spremenite datoteko, da je videti tako:

Ko shranite in zapustite urejevalnik, vas Git previje nazaj na zadnjo potrditev na seznamu in vas postavi v ukazno vrstico z naslednjim sporočilom:

Ta navodila vam povedo točno, kar morate narediti. Vpišite:

Spremenite sporočilo potrditve in zapustite urejevalnik. Nato poženite:

Ta ukaz bo samodejno uporabil drugi dve potrditvi in potem ste končali. Če na več vrsticah spremenite pick v edit, lahko za vsako potrditev, ki jo spremenite v edit, ponovite te korake. Vsakič se bo Git ustavil, vam dovolil popraviti potrditev in nadaljeval, ko končate.

Interaktivna ponovna baziranja lahko uporabite tudi za preureditev ali popolno odstranitev potrditev. Če želite odstraniti potrditev »Add cat-file« in spremeniti vrstni red, v katerem sta uvedeni drugi dve potrditvi, lahko spremenite skript ponovnega baziranja iz tega:

na to:

Ko shranite in zaprete urejevalnik, Git previje vašo vejo nazaj na nadrejeno teh potrditev, uporabi 310154e in nato f7f3f6d ter se nato ustavi. Učinkovito ste spremenili vrstni red teh potrditev in popolnoma odstranili potrditev »Add cat-file«.

Z interaktivnim orodjem ponovnega baziranja je možno združiti tudi serijo potrditev v eno samo potrditev. Skript v sporočilu ponovnega baziranja vključuje uporabna navodila:

Če namesto pick ali edit navedete squash, Git uporabi tako spremembo kot tudi spremembo neposredno pred njo in vas prosi, da združite sporočila potrditev. Če želite na primer ustvariti eno samo potrditev iz teh treh potrditev, lahko skript oblikujete na ta način:

Ko shranite in zapustite urejevalnik, bo Git uporabil vse tri spremembe in vas nato vrnil nazaj v urejevalnik, da združite tri sporočila potrditev.

Ko to shranite, boste imeli eno potrditev, ki vsebuje spremembe vseh treh prejšnjih potrditev.

Razdelitev (angl. splitting) potrditve razveljavi potrditev in jo delno doda v področje priprave ter nato potrdi tolikokrat s kolikor potrditev želite končati. Na primer, če želite razdeliti srednjo potrditev iz svojih treh potrditev. Namesto »Update README formatting and add blame« jo želite razdeliti na dve potrditvi: »Update README formatting« za prvo in »Add blame« za drugo. To lahko storite v skriptu rebase -i, tako da spremenite navodila na potrditvi, ki jo želite razdeliti, na edit:

Nato, ko vas skript spusti v ukazno vrstico, ponastavite to potrditev, vzamete spremembe, ki so bile ponastavljene, in iz njih ustvarite več potrditev. Ko shranite in zaprete urejevalnik, se Git premakne nazaj na nadrejeno prve potrditve na vašem seznamu, uporabi prvo potrditev (f7f3f6d), uporabi drugo (310154e) in vas spusti v konzolo. Tam lahko naredite mešano ponastavitev te potrditve z git reset HEAD^, ki učinkovito razveljavi to potrditev in pusti spremenjene datoteke izven področja priprave. Sedaj lahko označite in potrdite datoteke, dokler ne dobite več potrditev, in ko končate, zaženete git rebase --continue:

Git uporabi zadnjo potrditev v skriptu (a5f4a0d) in vaša zgodovina je videti takole:

To spremeni SHA-1 treh najnovejših potrditev na vašem seznamu, zato poskrbite, da nobena spremenjena potrditev, ki se pojavi na tem seznamu, že ni bila potisnjena v skupno rabo. Opazite, da je zadnja potrditev na seznamu (f7f3f6d) nespremenjena. Kljub temu, da je ta potrditev prikazana v skriptu, ker je bila označena kot pick in je bila uporabljena pred vsemi spremembami ponovnega baziranja, Git pusti potrditev nespremenjeno.

Če želite odstraniti potrditev, jo lahko izbrišete s pomočjo skripta rebase -i. Na seznamu potrditev pred tisto, ki jo želite izbrisati, vnesite besedo drop (ali pa samo izbrišite to vrstico iz skripta za ponovno baziranje):

Zaradi načina, kako Git gradi objekte potrditev, bo brisanje ali spreminjanje potrditve povzročilo ponovno pisanje vseh potrditev, ki sledijo. Bolj, ko se pomikate nazaj v zgodovino svojega repozitorija, več potrditev bo treba ustvariti. Če imate v zaporedju veliko potrditev, ki so odvisne od tiste, ki ste jo pravkar izbrisali, lahko to povzroči veliko konfliktov med združevanjem.

Če se nekje na sredini ponovnega baziranja odločite, da to ni dobra ideja, se lahko vedno ustavite. Vpišite git rebase --abort in vaš repozitorij se bo povrnil v stanje, v katerem je bil pred začetkom ponovnega baziranja.

Če končate ponovno baziranje in se odločite, da to ni to, kar želite, lahko uporabite git reflog, da obnovite prejšnjo različico svoje veje. Glejte razdelek Obnovitev podatkov za več informacij o ukazu reflog.

Obstaja še ena možnost spreminjanja zgodovine, ki jo lahko uporabite, če morate na neki skriptni način spremeniti večje število potrditev — na primer globalno spremeniti svoj e-poštni naslov ali odstraniti datoteko iz vsake potrditve. Ukaz je filter-branch in lahko ponovno napiše ogromne dele vaše zgodovine, zato ga verjetno ne bi smeli uporabljati, razen če vaš projekt še ni javen in drugi ljudje še niso temeljili na delu, ki ste ga ravno nameravali spremeniti. Vendar pa je lahko zelo uporaben. Naučili se boste nekaj običajnih uporab, da boste dobili predstavo o nekaterih stvareh, ki jih lahko naredi.