I conflitti, esercizi spiegati
Cinque esempi, un comando alla volta
- 20 minuti di lettura
Cinque esempi, dal più semplice. Ognuno ha lo stesso ritmo:
- Prevedi: leggi la situazione e scrivi su un foglio cosa succede. Prima di aprire la risposta.
- In italiano: cosa fa Git, a parole.
- Passo per passo: cosa cambia a ogni comando.
- 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
bash esempi/prepara.sh
cd esempi/progettoe 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 tabelloneIn 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 ◀── notturnoA · Il primo conflitto
Sei Lucia, su main. Unisci il lavoro di Marta.
git merge notturnoPrevedi 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 QueryIn italiano.
- Git trova il punto da cui le due strade sono partite (C3).
- Confronta riga per riga. La 6:00 e la 6:24 non sono cambiate da nessuno.
- La 6:12 è cambiata da tutte e due, in modo diverso: scrive nel file tutte e due le versioni, tra i tre segni.
- 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 QueryPoi:
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 tabelloneIn italiano.
- Scelgo cosa deve esserci e tolgo i tre segni. Qui ho tenuto la riga di Lucia.
git adddice a Git «questo file è sistemato».git commitchiude il merge.
Il disegno.
Passo per passo.
| Comando | Scrivania | Set | Album |
|---|---|---|---|
(dopo git merge notturno) | orari.txt con i segni | orari.txt in conflitto | C5, merge a metà |
| apri il file, scegli, togli i segni | orari.txt pulito | orari.txt ancora in conflitto | invariato |
git add orari.txt | pulita | orari.txt sistemato | invariato, merge ancora a metà |
git commit -m "…" | pulita | vuoto | C6, con due genitori: C5 e C4 |
Il disegno finale:
C1 ◀── C2 ◀── C3 ◀── C5 ◀── C6 ◀── main ◀── HEAD
▲ │
└── C4 ◀──────┘
▲
notturnoCosa 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.
git merge --abort
git statusPrevedi 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 cleanmain è 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.
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.
git switch notturno
git merge mainPrevedi 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 QuerySopra 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.
| Comando | HEAD | main | notturno | Commit nuovi |
|---|---|---|---|---|
git switch notturno | notturno | C5 | C4 | — |
git merge main | notturno, merge a metà | C5 | C4 | nessuno (conflitto) |
scegli, git add, git commit | notturno | C5 | C6 (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.)
git switch notturno
git rebase mainPrevedi 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 1E 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 QueryHEAD è 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:
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 tabelloneC1 ◀── C2 ◀── C3 ◀── C5 ◀── main
▲
└── C4' ◀── notturno ◀── HEADE 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.