Cum să redenumești o ramură în Git

Publicat: 2022-12-26

Sigla Git pe un fundal albastru

Pentru a redenumi ramura locală curentă, utilizați „git branch -m new-name”. Pentru a redenumi o ramură locală din interiorul alteia, utilizați „git branch -m old-name new-name”. Pentru a redenumi o ramură la distanță, ștergeți-o cu „git push origin --delete old-name”, apoi împingeți ramura locală redenumită cu „git push origin -u new-name”.

Branching-ul este un exercițiu banal în Git. Din păcate, sarcinile banale primesc rareori atenția cuvenită și se întâmplă greșeli. Dacă ați denumit greșit o ramură, va trebui să fie redenumită. Iată cum să faci asta.

Cuprins

De ce sunt importante numele de ramuri în Git
Listați ramurile în Git înainte de a le redenumește
Cum să redenumești o sucursală locală în Git
Cum să redenumești o ramură la distanță în Git
Redenumirea ramurilor este simplă

De ce sunt importante numele de ramuri în Git

Orice legătură cu ramurile din sistemele clasice de control al versiunilor (VCS) a fost o mare problemă. Era nevoie de o înțelegere coordonată a faptului că o ramură a fost adăugată sau fuzionată, iar toți cei care foloseau acel depozit trebuiau să se asigure că nu au făcut nimic – sau au uitat să facă ceva – pentru ca operațiunea să continue și să reușească.

Operațiunile care implicau sucursale au fost adesea foarte lente. A existat o penalizare de timp folosind ramuri. Git a fost conceput de la început pentru a fi diferit. Deoarece este un sistem de control al versiunilor distribuit, fiecare utilizator are o copie a depozitului complet pe mașina locală.

Git rebase: tot ce trebuie să știți
RELATED Git rebase: Tot ce trebuie să știți

Ramificarea pe mașina dvs. locală nu afectează pe nimeni altcineva decât dacă împingeți ramura într-un depozit de la distanță. Și în Git, operațiunile de ramuri sunt concepute pentru a fi la fel de ușor de utilizat, pe atât de rapid de finalizat. Ramificarea în Git este foarte ieftină din punct de vedere computațional. Este o acțiune banală în cadrul depozitului local.

De fapt, dezvoltatorii sunt încurajați să se ramifică și să se ramifică des. Sucursalele sunt doar un alt instrument din VCS-ul dvs. de care beneficiați. Ramurile nu sunt lucruri mari înfricoșătoare în Git, ele sunt una dintre caracteristicile sale cele mai utilizate.

Dar familiaritatea poate duce la dispreț. Sau, cel puțin, la o atenție ocazională pentru ramuri. Ramificarea poate fi rapidă și simplă în Git, dar trebuie totuși să fii concentrat atunci când creezi o ramură. Este ușor să tastați greșit un nume de ramură sau să introduceți un nume greșit, rezultând o ramură prost numită.

Dacă ramura va fi împinsă la depozitul de la distanță la un moment dat, trebuie să fie scrisă corect. Dacă nu este, va provoca confuzie atunci când alții încearcă să-l folosească.

LEGATE: Cum funcționează ramurile Git?

Listați ramurile în Git înainte de a le redenumește

Verificarea numelor actuale ale ramurilor este un prim pas bun. Comanda git branch listează ramurile pentru noi. Puteți vedea ramurile în depozitul local cu această comandă:

 ramură git 

Listarea ramurilor locale folosind comanda git branch

Filialele sunt listate pentru noi. Ramura curentă este evidențiată în verde și cu un asterisc.

Pentru a vedea ramurile și comenzile lor, puteți folosi comanda show-branch .

 git show-branch 

Listarea ramurilor și a comiterilor acestora cu comanda git show-branch

Puteți vedea ramurile din depozitul de la distanță incluzând opțiunea -r (la distanță).

 git branch -r 

Listarea ramurilor la distanță cu comanda git branch -r

Pentru a vedea ramurile locale și la distanță cu o singură comandă, utilizați opțiunea -a (toate).

 git branch -a 

Listarea ramurilor locale și la distanță cu comanda git branch -a

Avem mai multe sucursale locale decât sucursale la distanță. Ramura „feature16” nu a fost încă trimisă în depozitul de la distanță. Acesta este doar un aspect al funcționării normale, nu o problemă.

Problema noastră este că ramura „feature19” ar fi trebuit denumită „feature18”. Deci aceasta este greșeala pe care o vom corecta.

RELATE: Cum să actualizați și să mențineți ramuri Git separate

Cum să redenumești o sucursală locală în Git

Există două moduri prin care puteți redenumi o sucursală la nivel local. Puteți să verificați sucursala și să o redenumiți sau o puteți redenumi în timp ce lucrați într-o altă sucursală.

Pentru a redenumi ramura curentă , asigurați-vă că ați verificat și că utilizați ramura pe care doriți să o redenumiți. Apoi utilizați comanda git branch cu opțiunea -m (mutare).

 caracteristica git checkout19
 git branch -m feature18 

Verificați ramura „feature19” și redenumim-o

Am verificat ramura „feature19” și am redenumit-o „feature18”. Să vedem cum arată acum sucursalele noastre.

 ramură git 

Listarea ramurilor pentru a verifica că ramura „feature19” a fost redenumită „feature18”

Filiala noastră are acum numele corect în depozitul local.

Dacă doriți, puteți redenumi o sucursală atunci când lucrați într-o altă sucursală. Iată un exemplu în care lucrăm în ramura „master”.

 ramură git 

Afișează ramuri pentru a verifica dacă suntem pe filiala principală

Comanda pe care o folosim este aceeași comandă ca și înainte, dar trebuie să furnizăm numele curent pentru ramura pe care o redenumim, precum și noul nume pe care vrem să-l aibă.

 git branch -m feature19 feature18
 ramură git 

Redenumirea unei ramuri din interiorul altei ramuri

Din nou, ramura din depozitul nostru local a fost redenumită cu numele corect.

LEGATE: Cum să creați o nouă sucursală în GitHub

Cum să redenumești o ramură la distanță în Git

Depozitul de la distanță mai deține ramura cu vechiul nume. Pentru a redenumi o ramură la distanță, ștergem vechea ramură și împingem noua ramură.

Dacă alți utilizatori folosesc această ramură și se comite prin push, ar trebui să faceți o tragere înainte de a o redenumi local. Acest lucru vă asigură că depozitul dvs. local este actualizat și că modificările făcute de alți utilizatori nu se vor pierde. Retragerea modificărilor lor în depozit înainte de a redenumi ramura local înseamnă că acele modificări vor fi în noua ramură atunci când o împingeți înapoi în depozitul de la distanță.

Să aruncăm o privire asupra stării filialelor noastre. Vom folosi opțiunea -a (toate) pentru a vedea atât ramurile locale, cât și cele de la distanță.

 git branch -a 

Listarea ramurilor locale și la distanță cu comanda git branch -a

Trebuie să ștergem „feature19” din depozitul de la distanță și să împingem „feature18” pe telecomandă.

 git push origin --delete feature19 

Ștergerea unei ramuri la distanță folosind opțiunea git --delete

Vi se va solicita parola pentru depozitul de la distanță. Odată ce ștergerea a avut loc, veți vedea un mesaj de confirmare.

Acum vom împinge noua noastră ramură la telecomandă și vom folosi opțiunea -u (set upstream).

 git push origin -u feature18 

Împingeți o ramură către depozitul de la distanță

Din nou, vi se va solicita parola pentru telecomandă. Noua ramură este trimisă la telecomandă și ni se spune că ramura „feature18” este configurată pentru a urmări modificările din copia noastră locală a sucursalei.

Să verificăm încă o dată în ce stare se află sucursalele noastre locale și îndepărtate.

 git branch -a 

Listarea ramurilor locale și la distanță cu comanda git branch -a

Sucursala noastră a fost redenumită cu succes atât local, cât și de la distanță, iar sucursala la distanță urmărește modificările din sucursala noastră locală.

RELATE: Cum să ștergeți ramurile Git din arhivele locale și de la distanță

Redenumirea ramurilor este simplă

Cu Git, redenumirea ramurilor este simplă. Dacă ești singura persoană care folosește un depozit sau o ramură care necesită redenumire, este foarte simplu.

Dacă alții împărtășesc ramura, asigurați-vă că le comunicați că veți redenumi ramura și că ar trebui să împingă orice lucrare neangajată. După ce au împins, puteți trage ramura, apoi puteți redenumi ramura local și de la distanță.

RELATE: Cum să utilizați git cu mai multe depozite de la distanță