Résoudre manuellement les conflits de fusion

Bienvenue dans le monde des conflits de fusion ! Ne vous inquiétez pas : ils font normalement partie de la collaboration avec Git. Un conflit de fusion se produit lorsque Git ne parvient pas à déterminer automatiquement comment combiner les modifications de deux branches différentes.

Cela se produit généralement lorsque deux branches modifient de façons différentes les mêmes lignes du même fichier, ou lorsqu’une branche supprime un fichier qu’une autre branche a modifié.

Git est extrêmement efficace pour fusionner automatiquement la plupart des modifications. Cependant, il a besoin de l’aide d’une personne lorsqu’il rencontre une ambiguïté. Voici quelques situations courantes :

• Même ligne, modifications différentes : deux personnes modifient différemment exactement la même ligne de code.
• L’un supprime, l’autre modifie : une branche supprime un fichier tandis qu’une autre le modifie.
• Renommer ou modifier : un fichier est renommé dans une branche et modifié dans une autre.

Lorsqu’un conflit de fusion se produit, Git ne termine pas automatiquement la fusion. Il interrompt plutôt le processus et vous indique quels fichiers sont en conflit. Vous verrez un message semblable à celui-ci :

Après l’échec d’une fusion automatique, votre dépôt se trouve dans un état de « fusion ». Vous pouvez utiliser git status pour voir quels fichiers sont en conflit. Ces fichiers apparaissent dans la liste des « chemins non fusionnés ».

Git insère directement dans les fichiers en conflit des marqueurs spéciaux qui indiquent où se trouve le problème. Ces marqueurs vous aident à identifier les différentes versions du code :

• <<<<<<< HEAD : indique le début des modifications de votre branche actuelle.
• ======= : sépare les modifications des deux branches.
• >>>>>>> branch-name : indique la fin des modifications de la branche entrante.

Examinons un exemple. Imaginez que vous avez un fichier hello.txt. Votre branche main l’a modifié en « Hello from main », tandis qu’une branche feature a modifié la même ligne en « Greetings from feature ». Lors de la fusion de feature dans main, le fichier se présentera ainsi :

Votre tâche consiste à ouvrir le fichier en conflit (par exemple hello.txt) dans votre éditeur de texte. Ensuite, vous modifiez manuellement le fichier pour supprimer les marqueurs de conflit et choisir le contenu souhaité. Vous pouvez combiner des parties, choisir une version ou rédiger un contenu entièrement nouveau.

Dans notre exemple avec hello.txt, si nous voulons conserver les deux messages, nous pouvons le modifier ainsi :

Une fois le fichier modifié manuellement et tous les marqueurs de conflit supprimés, vous devez indiquer à Git que le conflit est résolu. Pour cela, vous indexez le fichier avec git add.

Répétez cette opération pour chaque fichier indiqué comme « chemin non fusionné » par git status.

Une fois tous les fichiers en conflit indexés, la fusion est prête à être validée. Git fournit généralement un message de validation de fusion par défaut, que vous pouvez accepter ou modifier. Cette validation finale termine le processus de fusion.

Vous avez réussi à résoudre un conflit de fusion. Vérifions maintenant votre compréhension de l’étape cruciale qui suit la modification manuelle d’un fichier en conflit.

Vous avez appris à résoudre manuellement les conflits de fusion ! C'est une compétence fondamentale pour tout développeur.

• Les conflits surviennent lorsque Git ne peut pas fusionner automatiquement les modifications.
• git status révèle les fichiers non fusionnés.
• Les marqueurs de conflit (<<<<<<<, =======, >>>>>>>) indiquent un code divergent.
• Modifiez manuellement les fichiers, supprimez les marqueurs et choisissez le contenu final.
• Ajoutez les fichiers résolus à l'index avec git add.
• Terminez la fusion avec git commit.

C'est en pratiquant que l'on progresse ! Les conflits peuvent sembler intimidants au début, mais ces étapes vous permettront de les maîtriser.