Branch e merge
Lavorare per conto tuo, poi unire le storie
- 10 minuti di lettura
Marta Villa vuole aggiungere al tabellone le corse della notte. Non è ancora sicura che vadano bene, e main è quello che vede tutta la Linea Menta: non vuole sporcarlo con una prova.
Un branch (in italiano: ramo) risolve proprio questo. Nel capitolo sul grafo l'hai disegnato: è un'etichetta attaccata a un commit, e avanza con i commit nuovi. Non è una copia dei file: creare un branch costa un secondo e non occupa spazio.
Questa pagina insegna i comandi per usarlo. Le regole d'oro sono sempre quelle del grafo: le citiamo per numero.
Far nascere un branch
git switch -c notturnoswitch (spostarsi) cambia branch. Con -c (create) il branch lo crea e ci va sopra. Nasce sul commit dove sei, e HEAD (il «tu sei qui») va sul branch nuovo:
C1 ◀── C2 ◀── C3 ◀── main
▲
notturno ◀── HEADNon è cambiato nessun file. Ma da adesso il prossimo commit nasce su notturno (regola 3), e main resta fermo:
C1 ◀── C2 ◀── C3 ◀── main
▲
└── C4 ◀── notturno ◀── HEADSpostarsi tra i branch
| Comando | Cosa fa |
|---|---|
git switch -c nome | Crea il branch e ci va sopra |
git switch nome | Va su un branch che c'è già |
git branch | Elenca i branch: quello con l'asterisco è dove sei |
git log --oneline --graph --all | Disegna tutta la storia, di tutti i branch, in verticale |
Quando cambi branch cambiano i file sulla scrivania: Git ti mostra la foto del commit su cui va HEAD. Se la corsa delle 23:40 è solo su notturno, tornando su main sparisce dal file, e ricompare quando torni su notturno. Non è persa: è nell'album.
Unire: il merge
Hai finito il lavoro sul branch e vuoi portarlo in main. Il comando è git merge, e c'è una regola sola da ricordare: il merge si lancia dal branch che riceve. Prima ti sposti su main, poi dici cosa vuoi dentro.
git switch main
git merge notturno --no-editCosa succede dipende da una domanda: main è andato avanti, dopo che è nato notturno?
No: main è fermo. La strada è una riga dritta. Non c'è niente da unire: Git sposta solo l'etichetta (regola 5). Si chiama fast-forward (avanti veloce) e non nasce nessun commit.
C1 ◀── C2 ◀── C3 ◀── main ◀── HEAD
▲
└── C4 ◀── notturno
C1 ◀── C2 ◀── C3 ◀── C4 ◀── main ◀── HEAD
▲
notturnoSì: le due storie si sono divise. Git non può spostare un'etichetta: serve un commit nuovo con due genitori, uno per strada (regola 4). Qui festivi ha il commit C4 e main il C5; il merge è C6.
C1 ◀── C2 ◀── C3 ◀── C5 ◀── C6 ◀── main ◀── HEAD
▲ │
└── C4 ◀──────┘
▲
festiviPrima di lanciare il merge, dunque, ti chiedi: nascerà un commit nuovo? Se main è fermo, no. Se è andato avanti, sì.
Il merge al contrario
A volte vuoi il contrario: sei sul tuo branch e main è andato avanti. Vuoi le novità di main dentro il tuo branch, per lavorare su una base aggiornata. Si lancia dal branch che riceve, cioè il tuo:
git switch avvisi
git merge main --no-editSi muove avvisi, non main. Se le due storie si erano divise, nasce un commit di merge sul tuo branch:
C1 ◀── C2 ◀── C3 ◀── C4 ◀── main
▲ ▲
│ └───┐
└── C5 ◀── C6 ◀── avvisi ◀── HEADCosa succede se sbagli verso? Stai su main e lanci git merge avvisi: si muove main, e avvisi resta indietro. È un errore comune, e la regola dà sempre la stessa risposta: chi riceve, si muove.
Cancellare un branch
Quando il lavoro è unito, l'etichetta non serve più. Ti sposti su main e:
git branch -d notturno-d (delete) toglie solo l'etichetta: i commit restano nell'album, perché ora main li raggiunge. E Git ti protegge: se il branch non è unito, i suoi commit non li raggiungerebbe più nessuno, e -d si rifiuta. Per forzare c'è -D maiuscola: butta anche il lavoro non unito. Non serve in questo libro.
Ho scritto sul branch sbagliato
Hai cominciato a modificare un file e solo dopo ti accorgi di essere su main. Non è un guaio: se non hai ancora fatto il commit, le modifiche non appartengono a nessun branch, stanno sulla scrivania. Fai nascere il branch adesso:
git switch -c nomeLe modifiche vengono con te, e fai il commit sul branch nuovo. main non ha visto niente. (Se Git si rifiuta di cambiare branch perché la modifica toccherebbe lo stesso file, è un'altra storia: la trovi nel capitolo su come rimettere a posto.)
Ricorda
- Un branch è un'etichetta:
git switch -cla crea e ci va sopra,git switchsi sposta. - Il merge si lancia dal branch che riceve:
git switch main, poigit merge nome --no-edit. mainfermo: fast-forward, nessun commit nuovo.mainandato avanti: commit di merge con due genitori.- Il merge al contrario porta
mainnel tuo branch: si muove il tuo branch,mainresta fermo. git branch -dtoglie l'etichetta di un branch già unito, e si rifiuta negli altri casi.- Le modifiche non salvate seguono
git switch -c: chi ha scritto sumainper sbaglio ripara in un attimo. - Se due storie cambiano le stesse righe, il merge si ferma e aspetta te: lo vediamo nel capitolo sui conflitti.