Conflits de fusion : ne paniquez pas - comprenons et résolvons

Trois types de conflits de fusion

• Contenu : modifications sur les mêmes lignes
• Renommages : fichier modifié et renommé
• Suppressions : fichier supprimé dans une branche, modifié dans l'autre
• Les renommages sont les plus délicats pour Git
• Vérifiez l'historique du fichier en cas de conflits suspects

Imaginez que vous travaillez sur un projet important et soudain, Git signale un conflit. La première étape vers la résolution est d'en comprendre le type. Les conflits de contenu surviennent lorsque des modifications ont affecté les mêmes lignes dans différentes branches. Les renommages sont plus complexes : un développeur change le nom du fichier pendant qu'un autre en modifie le contenu. Le troisième type concerne les suppressions, lorsqu'un fichier disparaît dans une branche mais continue d'exister dans l'autre. Ce sont les renommages qui posent le plus de difficultés car Git ne suit pas toujours correctement l'historique du fichier après un changement de nom. Par conséquent, en cas de conflits suspects, vérifiez toujours l'historique des modifications des fichiers.

Anatomie d'un conflit complexe

• Les marqueurs <<<<<<< indiquent vos modifications
• ======= sépare vos versions et celles des autres
• >>>>>>> marque la fin du bloc en conflit
• git status affichera tous les fichiers problématiques
• git diff — comparaison détaillée des modifications

Supposons que vous fusionniez la branche feature dans main et que vous voyez un message de conflit. Ouvrez les fichiers problématiques — vous remarquerez des marqueurs spéciaux. Tout ce qui se trouve entre <<<<<<< HEAD et ======= correspond à vos modifications. Entre ======= et >>>>>>> feature se trouvent les modifications de la branche à fusionner. Utilisez git status pour voir tous les fichiers en conflit, et git diff pour un aperçu détaillé des différences. N'oubliez pas : les marqueurs ne sont pas une erreur, mais une indication de l'endroit où vous devez prendre une décision.

#!/bin/bash
# analyse_conflit.sh

echo "Création d'un dépôt de test"
mkdir demo-conflit && cd demo-conflit
git init

echo "Création d'un fichier et premier commit dans main"
echo 'Ligne 1' > fichier.txt
echo 'Ligne 2' >> fichier.txt
git add . && git commit -m 'Commit initial'

echo "Création d'une branche feature et modification de la première ligne"
git checkout -b feature
sed -i 's/Ligne 1/Ligne 1 modifiée dans feature/' fichier.txt
git commit -am 'Modification de la ligne 1 dans feature'

echo "Retour à main et modification de la même ligne"
git checkout main
sed -i 's/Ligne 1/Ligne 1 modifiée dans main/' fichier.txt
git commit -am 'Modification de la ligne 1 dans main'

echo "Tentative de fusion des branches"
git merge feature || echo 'Conflit !'

echo "\nAffichage du statut :"
git status --short

echo "\nAffichage du fichier en conflit :"
cat fichier.txt

Stratégies de résolution des conflits

• Édition manuelle : supprimer les marqueurs, conserver le code souhaité
• Outils graphiques : meld, kdiff3 pour la comparaison visuelle
• --ours/--theirs : accepter sa version ou celle des autres
• Lors d'un rebase, les conflits sont résolus pour chaque commit
• Après résolution — n'oubliez pas git add et git commit

Lorsqu'un conflit est détecté, vous avez plusieurs options. Vous pouvez ouvrir le fichier manuellement, le modifier en supprimant les marqueurs et en conservant le code souhaité. Pour les visuels, des outils comme meld ou kdiff3 sont parfaits — ils affichent les trois versions du fichier simultanément. Si vous êtes sûr de vos modifications, utilisez git checkout --ours pour conserver votre version, ou --theirs pour celle des autres. Soyez particulièrement vigilant lors d'un rebase : les conflits peuvent survenir à chaque commit qui est rebasé.

#!/bin/bash
# resolve_strategies.sh

echo "Méthode 1 : Résolution manuelle"
echo 'Modifiez le fichier en supprimant les marqueurs de conflit'
echo 'Puis exécutez : git add fichier.txt'

echo "\nMéthode 2 : Accepter notre version"
git checkout --ours fichier.txt

echo "\nMéthode 3 : Accepter leur version"
git checkout --theirs fichier.txt

echo "\nMéthode 4 : Utiliser un outil de fusion"
echo 'git mergetool --tool=meld'

echo "\nAprès avoir choisi une méthode, finalisez la fusion :"
echo 'git commit -m "Résolution du conflit de fusion"'