Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

Git3. Branch e mergep. 52

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

Terminale
git switch -c notturno

switch (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 ◀── HEAD

Non è cambiato nessun file. Ma da adesso il prossimo commit nasce su notturno (regola 3), e main resta fermo:

C1 ◀── C2 ◀── C3 ◀── main
              ▲
              └── C4 ◀── notturno ◀── HEAD

Spostarsi tra i branch

ComandoCosa fa
git switch -c nomeCrea il branch e ci va sopra
git switch nomeVa su un branch che c'è già
git branchElenca i branch: quello con l'asterisco è dove sei
git log --oneline --graph --allDisegna 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.

Terminale
git switch main
git merge notturno --no-edit

Cosa 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
                     ▲
                     notturno

Sì: 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 ◀──────┘
                  ▲
                  festivi

Prima 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:

Terminale
git switch avvisi
git merge main --no-edit

Si 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 ◀── HEAD

Cosa 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:

Terminale
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:

Terminale
git switch -c nome

Le 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 -c la crea e ci va sopra, git switch si sposta.
  • Il merge si lancia dal branch che riceve: git switch main, poi git merge nome --no-edit.
  • main fermo: fast-forward, nessun commit nuovo. main andato avanti: commit di merge con due genitori.
  • Il merge al contrario porta main nel tuo branch: si muove il tuo branch, main resta fermo.
  • git branch -d toglie l'etichetta di un branch già unito, e si rifiuta negli altri casi.
  • Le modifiche non salvate seguono git switch -c: chi ha scritto su main per 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.