Tutorial su Git Merge: guida completa con esempi

Tipi di merge in Git

Capire i tipi di merge in Git ti aiuterà a scegliere la strategia giusta per il tuo scenario. Ecco i tre approcci più comuni al merge. 

Fast-forward merge

Quando il branch di base non ha nuovi commit da quando è stato creato il branch feature, Git usa un approccio fast-forward. 

Se il tuo nuovo branch feature viene aggiornato mentre il branch main resta invariato, il merge sposta il puntatore head di main al branch feature. 

Non viene creato alcun merge commit aggiuntivo, il che mantiene la cronologia dei commit pulita e lineare.

Three-way merge

Se sia il branch di base sia il branch feature hanno nuovi commit, Git troverà il loro antenato comune e creerà un nuovo merge commit. Questo commit combina le cronologie di entrambi i branch, preservando la cronologia del branch feature e del branch main.

Nell'esempio seguente, “E” e “G” sono nuovi commit sul branch main dopo la creazione del branch feature. 

      C---D---F (feature-branch)
     /         
A---B---E---G (main) 

Viene creato un nuovo merge commit, “M”, che preserva la cronologia di entrambi i branch main e feature. 

       C---D---F
      /         \
 A---B---E---G---M (main)

Squash merge

Lo squash merge combina tutte le modifiche di un branch feature in un singolo commit e lo unisce nel branch di destinazione. Non preserva la cronologia dei singoli commit del branch feature. 

git merge --squash feature_branch_name

Uno squash merge è particolarmente utile per evitare l'ingombro dovuto a molti piccoli commit, mantenendo comunque lo stato finale della feature nel branch di destinazione.

Unire più branch

Nei progetti grandi, potresti dover unire più branch—uno alla volta o tutti insieme. L'approccio scelto dipende dal tuo flusso di lavoro e dalla complessità delle modifiche. In questa sezione esplorerò entrambi i metodi e quando usarli efficacemente.

Unire più di un branch in sequenza

Per unire i branch uno per uno, usa il comando di merge in sequenza per ciascun branch feature. 

Passaggio 1: Passa al branch di destinazione nel quale vuoi unire le modifiche.

git checkout target_branch_name

Passaggio 2: Unisci il primo branch feature, come mostrato di seguito.

git merge feature_branch_1

Passaggio 3: Unisci il secondo branch feature come mostrato.

git merge feature_branch_2

Ripeti il processo finché tutti gli altri branch non sono stati uniti.

Unire più di un branch in parallelo

Segui questi passaggi per unire più branch feature in una volta sola.

Passaggio 1: Passa al branch di destinazione nel quale vuoi unire le modifiche.

git checkout target_branch_name

Passaggio 2: Esegui il seguente comando con più branch feature 

git merge feature_branch_1 feature_branch_2 feature_branch_3

Quando Git unisce più branch in parallelo, possono verificarsi conflitti. In tal caso, Git ti chiederà di risolverli manualmente.

Gestire i conflitti con merge multipli

Unire più branch non è sempre semplice—soprattutto quando un branch dipende da un altro. 

Per esempio, unire feature_x in main prima di feature_y può introdurre conflitti. Allo stesso modo, se branch diversi modificano gli stessi file, i merge paralleli possono portare a conflitti che richiedono una risoluzione attenta.

Segui questi passaggi per risolvere i conflitti di merge:

• Passaggio 1: esegui git status per vedere quali file causano conflitti.
• Passaggio 2: apri i file in conflitto e correggili.
• Passaggio 3: aggiungi le modifiche allo stage e fai il commit.

Capire la cronologia dei merge commit 

Per conflitti complessi, potresti aver bisogno di più informazioni di quelle fornite da git status. In questi casi, puoi usare comandi come git log o git show per approfondire la cronologia.

• git log: mostra l'intera cronologia dei commit, inclusi i merge commit. Questo aiuta a identificare un merge specifico in cui si verifica il problema. 
• git show: Se trovi un merge commit sospetto con il comando sopra, usa git show per ispezionarlo. Questo comando fornisce una vista dettagliata del commit, mostrando cosa è stato modificato durante il merge. Mostra anche un identificatore univoco per il branch padre prima che avvenga un determinato merge.
• git diff: Puoi prendere gli identificatori univoci dei branch padre e unito dai comandi precedenti e usare git diff per confrontare le modifiche tra questi due stati.

Best practice per il merge in Git

Il merge a volte può risultare caotico, soprattutto quando più sviluppatori lavorano sullo stesso codebase. 

Abbiamo visto come risolvere i conflitti quando si presentano, ma il modo migliore è prevenirli prima che accadano. In questa sezione vedremo consigli pratici per mantenere i merge scorrevoli e la cronologia di Git pulita.

Mantieni i branch piccoli e focalizzati

Branch molto grandi aumentano il rischio di sovrapposizione delle modifiche, portando a più conflitti. Per ridurre al minimo questo rischio, lavora su una singola funzionalità per branch e mantieni i branch piccoli e focalizzati.

Fai pull e merge frequentemente

Scarica le ultime modifiche dal repository remoto per mantenere aggiornato il tuo branch di base prima di eseguire il merge. Effettua regolarmente il pull degli aggiornamenti dal branch main nel tuo branch feature per tenerli sincronizzati. Questo previene conflitti ampi e complessi in seguito.

Usa gli strumenti di merge integrati in Git

Invece di modificare i file manualmente, puoi usare gli strumenti integrati di Git per risolvere i conflitti con un'interfaccia visuale. Quando esegui git mergetool, si aprono tre scelte:

• LOCAL - Versione del branch main. Scegliendo questa opzione mantieni il contenuto del file in conflitto dal branch main e ignori le modifiche del branch feature. 
• REMOTE - Versione del branch feature. Selezionando questa opzione applichi al file in conflitto il contenuto del branch feature.
• BASE - Combina le modifiche dei file in conflitto di entrambi i branch e le unisce. 

Unisci in ordine

Quando unisci più branch, l'ordine conta—soprattutto se una feature dipende da un'altra. Se feature_x dipende da feature_y, unire prima feature_x può introdurre conflitti. Per evitarlo, unisci sempre i branch seguendo l'ordine delle loro dipendenze, così da mantenere il processo fluido e ridurre al minimo i conflitti.

Squash merging 

Come già accennato, lo squash merge consolida tutti i commit di un branch feature in un singolo commit, mantenendo pulita la cronologia dei commit e riducendo i potenziali conflitti di merge.

Un approccio alternativo è il rebase, che applica le modifiche del branch feature direttamente sopra il branch di base. In questo modo si crea una cronologia lineare ed evita merge commit non necessari. Tuttavia, entrambi i metodi riscrivono la cronologia e non preservano i singoli commit del branch feature.

Conclusione

In questo tutorial su Git merge, abbiamo visto tutto, dalle basi del merge alle best practice per evitare conflitti. Capire come usare git merge in modo efficace aiuta i team a collaborare senza intoppi, mantenendo flussi di lavoro fluidi e una cronologia del codice pulita.

Se vuoi approfondire le tue competenze su Git, dai un'occhiata a questo corso intermedio su Git per padroneggiare flussi di lavoro e tecniche più avanzati!