Tutorial: come risolvere i conflitti di merge in Git

Tipi di merge

Git merge e rebase sono i due modi per integrare i commit dal branch di destinazione a quello sorgente. Inoltre, Git merge esegue un merge fast-forward o no-fast-forward. Se l’head del branch di destinazione esiste nel branch sorgente, per impostazione predefinita il tipo di merge sarà fast-forward; se manca, sarà no-fast-forward. Git rebase è un altro tipo di merge che riordina la cronologia dei commit del branch di destinazione. 

Merge fast-forward

Per impostazione predefinita, Git merge usa il fast-forward per integrare i commit mancanti nel branch di destinazione. Ad esempio, viene usato per aggiornare il branch locale da un server remoto tramite il comando pull. Il fast-forward non genera conflitti di merge, poiché Git non lo applicherà se l’head del branch di destinazione manca nel branch sorgente. 

Merge no-fast-forward

Un merge no-fast-forward è detto anche three-way o true merge. Crea un nuovo commit su un branch di destinazione integrando le modifiche sia del branch sorgente sia di quello di destinazione. Le modifiche vengono unite dopo l’ultimo commit comune in entrambi i branch. Nel nostro caso, è dopo C. Questo tipo di merge attiverà un conflitto di merge se il branch sorgente è in contrasto con quello di destinazione. Nel diagramma sopra, il commit di merge (X) viene creato integrando il branch sorgente e quello di destinazione, dove K ed E sono i genitori del commit di merge. 

Rebase 

Git rebase è un po’ diverso dagli altri tipi. Cambia la sequenza della cronologia dei commit del branch di destinazione. Il rebase integra il branch sorgente in modo tale che il branch di destinazione contenga tutte le modifiche dal branch sorgente, seguite da tutti i commit del branch di destinazione dopo l’ultimo commit comune. Nel nostro caso, l’ultimo commit comune è C, mentre D ed E provengono dal branch sorgente. Il commit K* è lo stesso di K con un id di commit diverso. Invece di collegarsi a C, si collegherà a E. Analogamente a un merge no-fast-forward, se ci sono problemi di compatibilità tra branch sorgente e destinazione, Git richiederà di risolvere i conflitti prima di finalizzare il rebase. 

Tipi di conflitti di merge in Git

Ci sono due tipi di conflitti di merge in Git: all’avvio e durante il processo di merging - Atlassian. In questa sezione vedremo entrambi i tipi e come risolvere ciascuno scenario. 

All’avvio del merge

Git merge fallirà all’avvio se ci sono modifiche nella working directory o nello staging area. Fallisce all’avvio per evitare che le modifiche vengano sovrascritte dai commit in arrivo durante il merge. Ciò avviene per conflitti con modifiche locali, non con altri branch o sviluppatori. Per stabilizzare lo stato locale, puoi usare comandi come git stash, git commit, git checkout o git reset.

Durante il merge

Un errore durante il merge indica un conflitto tra branch sorgente e destinazione in cui più sviluppatori hanno modificato lo stesso file. Se il merge automatico fallisce, Git ti chiederà di risolvere i problemi manualmente. Puoi anche usare strumenti di terze parti per aiutarti a visualizzare e integrare le modifiche.

Comandi per risolvere i conflitti di merge in Git

In questa sezione vedremo vari comandi nativi per visualizzare e risolvere i conflitti di merge in Git. 

Comandi comuni

Git status è il comando più usato per mostrare lo stato dei file modificati, dello staging area e dei commit. Durante il merge, viene usato per identificare i file in conflitto.  

git status

Git log con l’argomento --merge produce l’elenco dei commit che sono in conflitto con il branch sorgente. 

git log --merge

Per impostazione predefinita, l’opzione git diff ti mostra la differenza tra le modifiche non confermate e i commit precedenti. Git diff si usa per confrontare branch, commit e file. È utile per prevenire futuri conflitti di merge. 

git diff 

Comandi per i fallimenti all’avvio del merge

Checkout si usa per annullare modifiche o passare a un branch nuovo o vecchio. 

git checkout

Git reset serve a ripristinare le modifiche nella working directory e nello staging area. 

git reset --mixed

Comandi per conflitti durante il merge

L’argomento --abort interrompe il processo di merge e ripristina le modifiche allo stato originale prima dell’avvio del merge. 

git merge --abort

Git reset viene solitamente usato durante il merge per riportare i file in conflitto al loro stato originale.

git reset

Risolvi i conflitti deleted-modified

Un conflitto si verifica se hai eliminato il file nel branch corrente e qualcun altro lo ha modificato in un altro branch. In questo caso, puoi aggiungere il file e fare commit,

git add <filename>

oppure puoi rimuovere il file e fare commit. 

git rm <filename>

📌 Foglio di riferimento: risoluzione dei conflitti di merge in Git

Strumenti di merge visuali

Gli strumenti di merge sono tool visuali intuitivi per identificare e risolvere tutti i tipi di conflitti di merge. Alcuni supportano funzionalità aggiuntive come confronto delle modifiche, operazioni Git e gestione di progetti e repository. Esistono due tipi di strumenti di merge per Git: solo terminale e basati su GUI. Quelli da terminale si aprono in PowerShell o Bash, mentre quelli GUI si aprono in un ambiente a finestre. 

Per controllare l’elenco degli strumenti installati e validi, usa:

git mergetool --tool-help 

L’elenco comprende tutti gli strumenti validi che possono essere installati e integrati con i comandi git.

Per esempio, abbiamo vim e nvim installati per impostazione predefinita e, se vuoi vedere la differenza tra un file non confermato e un commit precedente, digita:

git difftool --tool=vimdiff3

Lo strumento vimdiff3 evidenzia le modifiche e ti consente di confrontare i commit all’interno del terminale. 

Differenza tra due versioni dello stesso file in vimdiff3

Meld

Meld è uno strumento gratuito e open source che porta la risoluzione dei conflitti di merge a un altro livello. Per integrarlo con Git, devi prima scaricare e installare il setup dal sito ufficiale. Poi aggiungilo alla configurazione globale, così Git avvierà Meld per impostazione predefinita per risolvere i conflitti.  

I comandi di configurazione seguenti si applicano solo agli utenti Windows. L’unica modifica necessaria su Mac o Linux è aggiornare il percorso dell’eseguibile di Meld. 

git config --global merge.tool meld 

git config --global mergetool.meld.path "C:/Program Files (x86)/Meld/Meld.exe" 

git config --global diff.tool meld

git config --global difftool.meld.path "C:/Program Files (x86)/Meld/Meld.exe"

Dopo aver impostato i valori predefiniti, puoi digitare git difftool nella directory locale Git per avviare la versione Windows di Meld, oppure git mergetool per risolvere i conflitti di merge come mostrato di seguito.

Risoluzione di un conflitto di merge con Meld

VSCode

VSCode offre il modo migliore e più popolare per risolvere i conflitti di merge. Quando Git non riesce a unire automaticamente i file, VSCode evidenzia il codice in conflitto e ti offre quattro opzioni: accetta le modifiche correnti, accetta le modifiche in arrivo, accetta entrambe le modifiche e confronta le modifiche. Puoi usare queste opzioni per ripulire il file e risolvere tutti i problemi in sospeso. 

Risoluzione di un conflitto di merge con VSCode

Se cerchi una soluzione completa per le tue operazioni Git, prova GitKraken. Include un client gratuito, un’estensione per VSCode e fornisce uno strumento integrato per risolvere i conflitti di merge.  

Come risolvere un conflitto di merge in Git

In questa sezione vedremo come creare un conflitto di merge in Git e poi risolverlo. Il tutorial è diviso in due parti. Nella prima impareremo a risolvere i conflitti di Git in locale; la seconda riguarda la risoluzione dei conflitti con un server remoto (GitHub).

Conflitto di merge locale

Creare conflitti di merge ci aiuterà a capire come nascono questi problemi. Potremo poi usare modi creativi per risolverli o persino prevenirli in futuro. 

Ora creeremo un repository Git con un singolo file e faremo il primo commit per iniziare. 

1. Crea una cartella chiamata datacamp.
2. Entra nella cartella datacamp.
3. Inizializza Git.
4. Crea un file README.md con il titolo indicato.
5. Fai stage e commit delle modifiche al file.

mkdir datacamp
cd datacamp
git init
echo "# How to Resolve Git Merge Conflict" > README.md
git add README.md
git commit -m "first commit"

>>> [main (root-commit) 8199ea2] first commit
>>>  1 file changed, 1 insertion(+)
>>> create mode 100644 README.md

Successivamente, creeremo un nuovo branch readme e cambieremo il titolo da “..Git Merge..” a “..Git..”. Aggiungi il file e crea il commit usando l’argomento -am.

git checkout -b readme
echo "# How to Resolve Git Conflict" > README.md
git commit -am "new branch conflict added"

>>> [readme 155f694] new branch conflict added
>>> 1 file changed, 1 insertion(+), 1 deletion(-)

Torna al branch main e aggiungi una nuova riga al file README.md usando >>. Salvando le modifiche e creando i commit, abbiamo generato con successo un conflitto tra due versioni dello stesso file. 

git checkout main
echo "New change in base branch" >> README.md
git commit -am " a line added to base branch Readme file"

>>> [main f1f1874]  a line added to base branch Readme file
>>> 1 file changed, 1 insertion(+)

Come possiamo vedere, durante il merge del branch readme, Git ha mostrato un messaggio che indica che il merge automatico è fallito e che dobbiamo apportare modifiche manualmente e poi fare commit del risultato. 

git merge readme

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

Risolviamo il problema manualmente aprendo e modificando il file in Notepad. L’immagine qui sotto mostra la freccia con HEAD, un separatore e una freccia in direzione opposta con readme. La parte HEAD mostra le modifiche esistenti nel branch main, mentre readme è il branch che vogliamo unire, con un’intestazione diversa. 

Risoluzione manuale di un conflitto di merge 

Per risolvere il problema, rimuoveremo la parte del branch readme, le frecce e il separatore. La versione finale del file dovrebbe essere pulita, come mostrato sotto. 

Conflitto risolto 

Dopo aver aggiunto il file e creato un commit, il conflitto di merge sarà risolto. È il modo più comune e semplice per risolvere i problemi. Puoi anche usare un IDE per velocizzare la risoluzione.

git commit -am "conflict resolved in file README.md"
>>> [main 9994a29] conflict resolved in file README.md

Conflitto di merge remoto

Per creare e risolvere conflitti di merge remoti, dobbiamo creare un nuovo repository su GitHub.

Creazione di un nuovo repository su GitHub

Poi aggiungi il nome del remoto (origin) con l’indirizzo del repository e pusha tutte le modifiche dal repository locale al branch main remoto usando upstream.

git remote add origin https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
git push --set-upstream origin main


>>> Enumerating objects: 12, done.
>>> Counting objects: 100% (12/12), done.
>>> Delta compression using up to 4 threads
>>> Compressing objects: 100% (6/6), done.
>>> Writing objects: 100% (12/12), 998 bytes | 499.00 KiB/s, done.
>>> Total 12 (delta 2), reused 0 (delta 0), pack-reused 0
>>> remote: Resolving deltas: 100% (2/2), done.
>>> To https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
>>>  * [new branch]      main -> main
>>> branch 'main' set up to track 'origin/main'.

Per creare un conflitto, dobbiamo apportare modifiche al file README.md sia sul remoto sia in locale. Puoi usare l’editor di file di GitHub per cambiare “..Git merge..” in “..Sit-Merge..” e poi fare commit delle modifiche. 

Modifica nell’editor di GitHub

Poi, nel repository locale, modifica il file README.md per aggiungere solo un titolo semplice e fai commit delle modifiche. 

echo "# How to Resolve Merge Conflicts in Git Tutorial" > README.md
git commit -am "local branch changes in README.md"

>>> [main c677a13] local branch changes in README.md
>>>  1 file changed, 1 insertion(+), 4 deletions(-)

Infine, pusha le modifiche sul server remoto. Nota che Git ha segnalato un errore con suggerimenti su come eliminarlo. 

git push


>>> To https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
>>>  ! [rejected]        main -> main (fetch first)
>>> error: failed to push some refs to 'https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git'
>>> hint: Updates were rejected because the remote contains work that you do
>>> hint: not have locally. This is usually caused by another repository pushing
>>> hint: to the same ref. You may want to first integrate the remote changes
>>> hint: (e.g., 'git pull ...') before pushing again.
>>> hint: See the 'Note about fast-forwards' in 'git push --help' for details.

Seguiamo il suggerimento più semplice, ovvero fare il pull dal server remoto prima di pusciare. 

Il pull del file è fallito a causa di un conflitto di merge nel file README.md. Potremmo risolverlo manualmente con Notepad, ma stavolta useremo uno strumento visuale per assisterci in questo processo. 

git pull


>>> remote: Enumerating objects: 5, done.
>>> remote: Counting objects: 100% (5/5), done.
>>> remote: Compressing objects: 100% (2/2), done.
>>> remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
>>> Unpacking objects: 100% (3/3), 681 bytes | 75.00 KiB/s, done.
>>> From https://github.com/kingabzpro/DataCamp-Git-Merge-Guide
>>>    aaf149d..49b7d14  main       -> origin/main
>>> Auto-merging README.md
>>> CONFLICT (content): Merge conflict in README.md
>>> Automatic merge failed; fix conflicts and then commit the result.

Lo strumento di merge Meld identificherà i file in conflitto e li mostrerà nell’applicazione GUI di Meld.   

git mergetool

>>> Merging:
>>> README.md

>>> Normal merge conflict for 'README.md':
>>>   {local}: modified file
>>>   {remote}: modified file

Ci sono tre colonne: README_LOCAL_473.md, README.md e README_LOCAL_473.md. Se ritieni valide le modifiche remote, fai clic sulla freccia nera nella colonna remota; se vuoi mantenere le modifiche locali, fai clic sulla freccia nera nella colonna locale. È semplice così. 

Conflitto risolto con lo strumento di merge Meld

Dopo aver apportato le modifiche, salva il file e fai commit. Come puoi vedere, il push di un file su un server remoto non genera più l’errore di conflitto di merge.

git commit -am "remote main branch conflict resolved"
git push

>>> Enumerating objects: 16, done.
>>> Counting objects: 100% (16/16), done.
>>> Delta compression using up to 4 threads
>>> Compressing objects: 100% (6/6), done.
>>> Writing objects: 100% (10/10), 1.08 KiB | 550.00 KiB/s, done.
>>> Total 10 (delta 2), reused 0 (delta 0), pack-reused 0
>>> remote: Resolving deltas: 100% (2/2), completed with 1 local object.
>>> To https://github.com/kingabzpro/DataCamp-Git-Merge-Guide.git
>>>    49b7d14..8f5c3aa  main -> main

Abbiamo risolto con successo i conflitti di merge sia locali che remoti. Questi conflitti vengono gestiti quotidianamente da data scientist e machine learning engineer. Per migliorare le tue competenze nelle operazioni Git, segui il corso Introduction to Git. 

Conclusione

Risolvere i conflitti di merge in Git è un compito complesso e ad alto rischio, perché puoi compromettere il software unendo codice difettoso. Gli strumenti di merge offrono un ambiente intuitivo e più sicuro per individuare e risolvere i conflitti di merge. In questo tutorial abbiamo visto perché si verificano i conflitti in Git e come risolverli. Abbiamo anche trattato vari tipi di merge e di conflitto, comandi Git utili e strumenti visuali. Nella sezione finale, abbiamo creato un conflitto di merge e lo abbiamo risolto in un repository locale e uno remoto. 

Se sei alle prime armi con Git e vuoi capire come funziona, leggi: Intro to Git and GitHub Tutorial.