Vai al contenuto
code-to-code

Apro l'indice…

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

Git4. I conflittip. 81

I conflitti, esercizi spiegati

Cinque esempi, un comando alla volta

  • 20 minuti di lettura

Cinque esempi, dal più semplice. Ognuno ha lo stesso ritmo:

  1. Prevedi: leggi la situazione e scrivi su un foglio cosa succede. Prima di aprire la risposta.
  2. In italiano: cosa fa Git, a parole.
  3. Passo per passo: cosa cambia a ogni comando.
  4. Cosa portiamo a casa: la cosa da ricordare.

Puoi rifare ogni esempio sul tuo computer. Nello zip della palestra c'è la cartella esempi/: dalla cartella principale dello zip lancia

Terminale
bash esempi/prepara.sh
cd esempi/progetto

e nasce il tabellone di Lucia Ferri con i suoi tre commit (5c2c617, 1ece7ce, b12df3f), più due commit nuovi sulla stessa riga: 4ca37c3 di Lucia su main e 93ec653 di Marta Villa sul branch notturno. Ogni volta che vuoi ricominciare, rilancia bash esempi/prepara.sh.

$ git log --oneline --graph --all
* 4ca37c3 Mette la 6:12 al binario 2
| * 93ec653 Mette la 6:12 al binario 1
|/  
* b12df3f Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabellone

In disegno: C1, C2, C3 sono i commit di Lucia, C4 è quello di Marta (93ec653), C5 quello di Lucia su main (4ca37c3).

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

A · Il primo conflitto

Sei Lucia, su main. Unisci il lavoro di Marta.

Terminale
git merge notturno
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Cosa dice Git? Nasce un commit nuovo? E cosa c'è dentro orari.txt?

Auto-merging orari.txt
CONFLICT (content): Merge conflict in orari.txt
Automatic merge failed; fix conflicts and then commit the result.

No: non nasce nessun commit. Git ha provato, ha trovato la stessa riga cambiata in due modi e si è fermato a metà. git status:

On branch main
You have unmerged paths.
  (fix conflicts and run "git commit")
  (use "git merge --abort" to abort the merge)

Unmerged paths:
  (use "git add <file>..." to mark resolution)
        both modified:   orari.txt

no changes added to commit (use "git add" and/or "git commit -a")

E il file:

06:00 M12 per Piazza Query
<<<<<<< HEAD
06:12 M14 per Piazza Query, binario 2
=======
06:12 M14 per Piazza Query, binario 1
>>>>>>> notturno
06:24 M16 per Piazza Query

In italiano.

  1. Git trova il punto da cui le due strade sono partite (C3).
  2. Confronta riga per riga. La 6:00 e la 6:24 non sono cambiate da nessuno.
  3. La 6:12 è cambiata da tutte e due, in modo diverso: scrive nel file tutte e due le versioni, tra i tre segni.
  4. Si ferma e aspetta.

Sopra ======= c'è la versione di dove sei: HEAD, cioè main, cioè Lucia (binario 2). Sotto quella che arriva: notturno, cioè Marta (binario 1).

Cosa portiamo a casa. Il conflitto riguarda solo le righe tra i segni. Il resto del file è già a posto. E git status dice sempre in quale file lavorare: both modified.


B · Risolvere

Siamo ancora nel merge dell'esempio A. Lucia e Marta si sentono: la 6:12 parte dal binario 2. Lucia apre orari.txt e lo fa diventare così:

06:00 M12 per Piazza Query
06:12 M14 per Piazza Query, binario 2
06:24 M16 per Piazza Query

Poi:

Terminale
git add orari.txt
git commit -m "Unisce le due versioni della 6:12"
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Dopo il git add cosa dice git status? E il commit, quanti genitori ha?

Dopo git add:

On branch main
All conflicts fixed but you are still merging.
  (use "git commit" to conclude merge)

Il commit ha due genitori, come ogni merge (regola 4): git log --format='%h %p' -1 dà fe4e6af 4ca37c3 93ec653, il suo codice e i codici dei due genitori. Il tuo codice sarà diverso.

$ git log --oneline --graph --all
*   fe4e6af Unisce le due versioni della 6:12
|\  
| * 93ec653 Mette la 6:12 al binario 1
* | 4ca37c3 Mette la 6:12 al binario 2
|/  
* b12df3f Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabellone

In italiano.

  1. Scelgo cosa deve esserci e tolgo i tre segni. Qui ho tenuto la riga di Lucia.
  2. git add dice a Git «questo file è sistemato».
  3. git commit chiude il merge.

Il disegno.

inizio git merge notturno passo conflitto in orari.txt passo scegli e togli i segni passo git add orari.txt passo git commit fine merge chiusogit merge notturnoconflitto in orari.txtscegli e togli i segnigit add orari.txtgit commitmerge chiuso
Risolvere un conflitto

Passo per passo.

ComandoScrivaniaSetAlbum
(dopo git merge notturno)orari.txt con i segniorari.txt in conflittoC5, merge a metà
apri il file, scegli, togli i segniorari.txt pulitoorari.txt ancora in conflittoinvariato
git add orari.txtpulitaorari.txt sistematoinvariato, merge ancora a metà
git commit -m "…"pulitavuotoC6, con due genitori: C5 e C4

Il disegno finale:

C1 ◀── C2 ◀── C3 ◀── C5 ◀── C6 ◀── main ◀── HEAD
              ▲             │
              └── C4 ◀──────┘
                  ▲
                  notturno

Cosa portiamo a casa. Quattro mosse: scegli, togli i segni, git add, git commit. La scelta può anche essere una terza versione che non c'era.


C · Meglio fermarsi

Rifai l'esempio A (bash esempi/prepara.sh, poi git merge notturno). Apri il file e capisci che la 6:12 non è una scelta tua: bisogna chiederlo a Marta. Torni indietro.

Terminale
git merge --abort
git status
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Cosa dice git status? Dov'è main? E il branch di Marta?

On branch main
nothing to commit, working tree clean

main è ancora a 4ca37c3, e notturno a 93ec653: nessuno si è mosso. Il file è tornato com'era, senza segni. Il disegno è quello di prima del merge.

In italiano. Il merge era a metà. git merge --abort lo butta e riporta tutto a prima del merge. Non perdi niente, perché non avevi ancora fatto niente.

Funziona solo finché il merge è a metà. Se hai già fatto il commit:

$ git merge --abort
fatal: There is no merge to abort (MERGE_HEAD missing).

MERGE_HEAD è il segnalibro che Git tiene per ricordare «sto unendo questo»: appena fai il commit sparisce, e non c'è più niente da annullare.

Il disegno.

inizio git merge --abort se il merge è ancora a metà sì: main e file come prima no: errore no merge to abort finegit merge --abortil merge è ancora ametàno merge to abortmain e file come primafinenosì
Annullare un merge

Cosa portiamo a casa. --abort è il pulsante d'emergenza: prima del commit del merge, sempre. Dopo non serve più, e non fa niente.


D · Il conflitto sul tuo branch

Sei Marta, sul tuo branch notturno. Vuoi portarci dentro main, prima di chiedere la pull request.

Terminale
git switch notturno
git merge main
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Chi sta sopra =======, e chi sotto?

06:00 M12 per Piazza Query
<<<<<<< HEAD
06:12 M14 per Piazza Query, binario 1
=======
06:12 M14 per Piazza Query, binario 2
>>>>>>> main
06:24 M16 per Piazza Query

Sopra c'è HEAD, cioè dove sei: il tuo branch, con il tuo binario 1. Sotto c'è main, quello che arriva. Rispetto all'esempio A le righe sono scambiate, ma la regola è la stessa.

In italiano. È lo stesso conflitto, visto dall'altra parte. Il merge lo lanci sempre dal branch che riceve: stavolta è il tuo, quindi HEAD è notturno e main è «quello che arriva».

Passo per passo.

ComandoHEADmainnotturnoCommit nuovi
git switch notturnonotturnoC5C4—
git merge mainnotturno, merge a metàC5C4nessuno (conflitto)
scegli, git add, git commitnotturnoC5C6 (due genitori: C4 e C5)C6

main non si è mosso: il conflitto l'hai risolto a casa tua, e quando chiederai la pull request non ci saranno sorprese.

Cosa portiamo a casa. Sopra ======= c'è sempre dove sei. Cambia chi sei: quindi, prima di scegliere, guarda il nome in fondo al blocco.


E · Nel rebase

Rifai l'esempio dall'inizio e dal branch di Marta lancia il rebase: ricopia il commit di Marta in fondo a main. (Il rebase lo spiega meglio il capitolo Rimettere a posto: qui ti serve solo il conflitto.)

Terminale
git switch notturno
git rebase main
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Chi sta sopra =======? Quale parte tieni per salvare il lavoro di Marta?

Rebasing (1/1)Auto-merging orari.txt
CONFLICT (content): Merge conflict in orari.txt
error: could not apply 93ec653... Mette la 6:12 al binario 1

E nel file:

06:00 M12 per Piazza Query
<<<<<<< HEAD
06:12 M14 per Piazza Query, binario 2
=======
06:12 M14 per Piazza Query, binario 1
>>>>>>> 93ec653 (Mette la 6:12 al binario 1)
06:24 M16 per Piazza Query

HEAD è al contrario. Sopra c'è main (binario 2): durante il rebase Git si sposta su main e ci ricopia sopra, uno alla volta, i tuoi commit. Sotto c'è il commit che sta ricopiando (93ec653, di Marta). Per salvare il lavoro di Marta si tiene la parte sotto.

git status dice dove sei:

interactive rebase in progress; onto 4ca37c3
Last command done (1 command done):
   pick 93ec653 Mette la 6:12 al binario 1
No commands remaining.
You are currently rebasing branch 'notturno' on '4ca37c3'.
  (fix conflicts and then run "git rebase --continue")
  (use "git rebase --skip" to skip this patch)
  (use "git rebase --abort" to check out the original branch)

Marta tiene la sua versione: il file diventa quello con il binario 1. Poi:

Terminale
git add orari.txt
git rebase --continue
[detached HEAD c51af56] Mette la 6:12 al binario 1
 Author: Marta Villa <marta.villa@lineamenta.example>
 1 file changed, 1 insertion(+), 1 deletion(-)
Successfully rebased and updated refs/heads/notturno.

In italiano. Il rebase prende il commit di Marta, lo ricopia sopra main e per la riga contesa si ferma. Si chiude con git add e git rebase --continue (non git commit).

Alla fine la storia è dritta, e il commit di Marta ha un codice nuovo, perché è una copia:

$ git log --oneline --graph --all
* c51af56 Mette la 6:12 al binario 1
* 4ca37c3 Mette la 6:12 al binario 2
* b12df3f Aggiunge gli orari del mattino
* 1ece7ce Aggiunge le fermate della Linea Menta
* 5c2c617 Primo commit: il README del tabellone
C1 ◀── C2 ◀── C3 ◀── C5 ◀── main
                     ▲
                     └── C4' ◀── notturno ◀── HEAD

E se ci ripensi, a metà: git rebase --abort riporta il branch com'era prima del rebase.

Cosa portiamo a casa. Nel rebase HEAD è al contrario: sopra main, sotto il tuo commit. Si chiude con git add e git rebase --continue; si scappa con git rebase --abort.