Conflitti di unione: niente panico — analizziamo e risolviamo

Tre tipi di conflitti di unione

• Di contenuto: modifiche sulle stesse righe
• Di rinomina: file modificato e rinominato
• Di cancellazione: file eliminato in un ramo, modificato in un altro
• Le rinomine sono le più insidiose per Git
• Controllate la cronologia del file in caso di conflitti sospetti

Immaginate di lavorare a un progetto importante e all'improvviso Git segnala un conflitto. Il primo passo per risolverlo è capirne il tipo. I conflitti di contenuto si verificano quando le modifiche interessano le stesse righe in rami diversi. Con le rinomine è più complesso: uno sviluppatore cambia il nome del file, mentre un altro ne modifica il contenuto contemporaneamente. Il terzo tipo sono le cancellazioni, quando un file scompare in un ramo ma continua a esistere in un altro. Sono proprio le rinomine a causare più spesso difficoltà, perché Git non sempre traccia correttamente la cronologia del file dopo un cambio di nome. Per questo motivo, in caso di conflitti sospetti, controllate sempre la cronologia delle modifiche dei file.

Anatomia di un conflitto complesso

• I marcatori <<<<<<< mostrano le vostre modifiche
• ======= separa la vostra versione da quella altrui
• >>>>>>> segna la fine del blocco in conflitto
• git status mostrerà tutti i file problematici
• git diff — confronto dettagliato delle modifiche

Supponiamo che stiate unendo il ramo feature in main e vediate un messaggio di conflitto. Aprite i file problematici: noterete dei marcatori speciali. Tutto ciò che si trova tra <<<<<<< HEAD e ======= sono le vostre modifiche. Tra ======= e >>>>>>> feature ci sono le modifiche del ramo che state unendo. Usate git status per vedere tutti i file in conflitto e git diff per un confronto dettagliato. Ricordate: i marcatori non sono un errore, ma un suggerimento su dove dovete prendere una decisione.

#!/bin/bash
# conflict_analysis.sh

echo "Creiamo un repository di test"
mkdir conflict-demo && cd conflict-demo
git init

echo "Creiamo un file e il primo commit in main"
echo 'Linea 1' > file.txt
echo 'Linea 2' >> file.txt
git add . && git commit -m 'Commit iniziale'

echo "Creiamo il ramo feature e modifichiamo la prima riga"
git checkout -b feature
sed -i 's/Linea 1/Linea 1 modificata in feature/' file.txt
git commit -am 'Modifica linea 1 in feature'

echo "Torniamo in main e modifichiamo la stessa riga"
git checkout main
sed -i 's/Linea 1/Linea 1 modificata in main/' file.txt
git commit -am 'Modifica linea 1 in main'

echo "Proviamo a unire i rami"
git merge feature || echo 'Conflitto!'

echo "\nVisualizziamo lo stato:"
git status --short

echo "\nMostriamo il file in conflitto:"
cat file.txt

Strategie di risoluzione dei conflitti

• Modifica manuale: rimuovere i marcatori, mantenere il necessario
• Strumenti GUI: meld, kdiff3 per il confronto visivo
• --ours/--theirs: accettare la propria o la versione altrui
• Con rebase i conflitti si risolvono per ogni commit
• Dopo la risoluzione — non dimenticare git add e git commit

Quando viene rilevato un conflitto, avete diverse strade. Potete aprire il file manualmente e modificarlo, rimuovendo i marcatori e lasciando il codice desiderato. Per i visivi sono adatti strumenti come meld o kdiff3 — mostrano tre versioni del file contemporaneamente. Se siete sicuri delle vostre modifiche, usate git checkout --ours per mantenere la vostra versione, o --theirs per quella altrui. Bisogna essere particolarmente attenti con rebase: qui i conflitti possono verificarsi su ogni commit che viene riorganizzato.

#!/bin/bash
# resolve_strategies.sh

echo "Metodo 1: Risoluzione manuale"
echo 'Modificate il file, rimuovendo i marcatori di conflitto'
echo 'Quindi eseguite: git add file.txt'

echo "\nMetodo 2: Accettare la nostra versione"
git checkout --ours file.txt

echo "\nMetodo 3: Accettare la loro versione"
git checkout --theirs file.txt

echo "\nMetodo 4: Usare uno strumento di unione"
echo 'git mergetool --tool=meld'

echo "\nDopo aver scelto il metodo, completate l'unione:"
echo 'git commit -m "Risolto conflitto di unione"'