Risoluzione manuale dei conflitti di merge

Benvenuto nel mondo dei conflitti di merge! Non si preoccupi: sono una parte normale della collaborazione con Git. Un conflitto di merge si verifica quando Git non riesce a determinare automaticamente come combinare le modifiche provenienti da due branch diversi.

Di solito accade quando due branch modificano in modi diversi le stesse righe dello stesso file, oppure quando un branch elimina un file modificato da un altro branch.

Git è estremamente efficace nell'unire automaticamente la maggior parte delle modifiche. Tuttavia, di fronte all'ambiguità ha bisogno dell'intervento umano. Ecco alcuni scenari comuni:

• Stessa riga, modifiche diverse: due persone modificano in modo diverso esattamente la stessa riga di codice.
• Uno elimina, l'altro modifica: un branch elimina un file mentre un altro branch lo modifica.
• Rinomina e modifica: un file viene rinominato in un branch e modificato in un altro.

Quando si verifica un conflitto di merge, Git non completa automaticamente l'operazione. Invece, mette in pausa il processo e indica quali file contengono conflitti. Verrà visualizzato un messaggio simile a questo:

Dopo il fallimento di un merge automatico, il repository si troverà nello stato "merging". Può usare git status per vedere quali file sono in conflitto. Questi file verranno elencati come "unmerged paths".

Git inserisce marcatori speciali direttamente nei file in conflitto per mostrare dove si trova il problema. Questi marcatori aiutano a identificare le diverse versioni del codice:

• <<<<<<< HEAD: indica l'inizio delle modifiche del branch corrente.
• =======: separa le modifiche dei due branch.
• >>>>>>> branch-name: indica la fine delle modifiche del branch in arrivo.

Vediamo un esempio. Immagini di avere un file hello.txt. Il branch main lo ha modificato in "Hello from main", mentre un branch feature ha modificato la stessa riga in "Greetings from feature". Quando si integra feature in main, il file apparirà così:

Il suo compito è aprire il file in conflitto, ad esempio hello.txt, nell'editor di testo. Deve quindi modificare manualmente il file per rimuovere i marcatori di conflitto e scegliere il contenuto desiderato. Può combinare parti diverse, scegliere una delle versioni oppure scrivere qualcosa di completamente nuovo.

Nel nostro esempio con hello.txt, se volessimo mantenere entrambi i messaggi, potremmo modificarlo così:

Dopo aver modificato manualmente il file e rimosso tutti i marcatori di conflitto, deve comunicare a Git che il conflitto è stato risolto. Per farlo, prepari il file con git add.

Ripeta questa operazione per ogni file elencato come "unmerged paths" da git status.

Dopo aver preparato tutti i file in conflitto, il merge è pronto per essere sottoposto a commit. In genere Git propone un messaggio predefinito per il commit di merge, che può accettare o modificare. Questo commit finale completa il processo di merge.

Ha risolto correttamente un conflitto di merge. Ora verifichiamo la sua comprensione del passaggio fondamentale successivo alla modifica manuale di un file in conflitto.

Ha imparato a risolvere manualmente i conflitti di merge! È una competenza fondamentale per qualsiasi sviluppatore.

• I conflitti si verificano quando Git non riesce a eseguire automaticamente il merge delle modifiche.
• git status mostra i file non sottoposti a merge.
• I marcatori di conflitto (<<<<<<<, =======, >>>>>>>) mostrano il codice divergente.
• Modifichi manualmente i file, rimuova i marcatori e scelga il contenuto finale.
• Aggiunga all'area di staging i file risolti con git add.
• Completi il merge con git commit.

La pratica porta alla perfezione! All'inizio i conflitti possono sembrare intimidatori, ma seguendo questi passaggi imparerà a gestirli con sicurezza.