Merge avancé : stratégies, conflits et rerere

git rerere mémorise vos résolutions de conflits pour les rejouer automatiquement, -Xours/-Xtheirs tranche les conflits en faveur d'un côté, et --squash fusionne sans commit de merge. Ce guide couvre les techniques avancées pour les merges complexes.

Prérequis : Merge et conflits et Reset démystifié.

Ce que vous allez apprendre

• Annuler un merge en cours avec --abort sans laisser de traces
• Favoriser une stratégie avec -Xours ou -Xtheirs pour les conflits massifs
• Configurer rerere pour que Git mémorise vos résolutions de conflits

Annuler un merge en cours

Avant le commit de merge

Si un merge produit des conflits et que vous voulez tout annuler :

git merge --abort

La commande tente de reconstruire l'état d'avant le git merge, et c'est le mot que la documentation emploie. Elle y parvient presque toujours, mais pas quand le merge a démarré avec des modifications non commitées non triviales. Commitez ou remisez avant de fusionner : c'est la recommandation de la documentation elle-même, et elle vous épargne entièrement ce cas.

Après le commit de merge

Si le merge est déjà commité mais vous changez d'avis :

# Annuler le commit de merge (crée un commit d'annulation)
git revert -m 1 HEAD

-m 1 indique quel parent garder (1 = la branche dans laquelle vous étiez).

Revert d'un merge

Après avoir reverté un merge, un futur merge de la même branche n'importera pas les commits déjà mergés puis revertés. Il faudra reverter le revert avant de re-merger.

Stratégies de résolution des conflits

-Xours et -Xtheirs

Ne pas confondre -Xours et la stratégie -s ours

Ces deux options se ressemblent mais font des choses très différentes :

Option	Effet
-Xours	Résout automatiquement les conflits en faveur de la branche courante, les fichiers sans conflit sont fusionnés normalement
-s ours	Ignore complètement l'autre branche, aucun de ses commits n'est intégré

Glissez pour voir

En pratique, vous voudrez presque toujours -Xours, jamais -s ours (sauf cas très spécifiques de merge de maintenance).

Au lieu de résoudre manuellement chaque conflit :

# En cas de conflit, garder notre version
git merge -Xours feature

# En cas de conflit, garder leur version
git merge -Xtheirs feature

• -Xours : pour chaque conflit, garde le code de la branche courante
• -Xtheirs : pour chaque conflit, garde le code de la branche mergée

Les fichiers sans conflit sont mergés normalement dans les deux cas.

Ne confondez plus -Xours et -Xtheirs

Ce point est déjà expliqué plus haut sous forme de tableau dans l'encadré de mise en garde. Consultez-le si vous avez un doute.

Résoudre fichier par fichier

Pour un contrôle fin, résolvez chaque fichier individuellement :

# En plein conflit, garder notre version de ce fichier
git checkout --ours -- src/config.py
git add src/config.py

# Garder leur version de cet autre fichier
git checkout --theirs -- src/utils.py
git add src/utils.py

# Finaliser le merge
git commit

git merge --squash

--squash applique toutes les modifications d'une branche sans créer de commit de merge :

git merge --squash feature
# Toutes les modifications sont dans le staging
git commit -m "feat: intégrer la feature X"

Le résultat est un commit unique (pas de second parent). L'historique de la branche feature est « aplati ».

Critère	Merge normal	Merge --squash
Commit de merge	Oui (2 parents)	Non (1 parent, commit classique)
Historique de la branche	Préservé	Perdu (aplati)
git log --graph	Montre la divergence	Linéaire
Traçabilité	Chaque commit visible	Un seul commit résumé

Glissez pour voir

Quand utiliser --squash :

• Branche feature avec beaucoup de commits WIP/debug
• Vous voulez un historique linéaire propre
• Les commits individuels n'apportent pas de valeur informative

git rerere : mémoriser les résolutions

"REuse REcorded Résolution", Git mémorise comment vous résolvez un conflit et l'applique automatiquement si le même conflit se reproduit.

Activer rerere

git config --global rerere.enabled true

Comment ça fonctionne

1. Un conflit survient et vous le résolvez manuellement.

2. Git enregistre la résolution dans .git/rr-cache/.

3. Plus tard, le même conflit sur les mêmes lignes se reproduit (rebase, merge d'une autre branche...).

4. Git applique automatiquement la résolution enregistrée.

   Resolved 'src/config.py' using previous resolution.

5. Vérifiez et commitez :

   git diff         # Vérifier la résolution
   git add .
   git commit

Commandes rerere

# Voir les résolutions en attente
git rerere status

# Voir le diff des résolutions
git rerere diff

# Oublier une résolution enregistrée
git rerere forget src/config.py

# Vider tout le cache rerere
git rerere gc

Cas d'usage parfait

Vous maintenez une branche longue qui doit régulièrement intégrer main. Les mêmes conflits reviennent à chaque merge. Avec rerere, vous les résolvez une fois et Git s'en souvient.

Conflits sur fichiers binaires

Git ne peut pas merger des fichiers binaires (images, PDF, archives). En cas de conflit :

# Garder notre version
git checkout --ours -- image.png
git add image.png

# Ou garder leur version
git checkout --theirs -- image.png
git add image.png

Pour des comparaisons visuelles, configurez un outil externe :

.gitattributes

*.png diff=exif

# .gitconfig
[diff "exif"]
    textconv = exiftool

Merge subtree

Merge un dépôt externe comme sous-dossier d'un projet :

# Ajouter le dépôt comme remote
git remote add lib-utils https://git.example.com/lib-utils.git
git fetch lib-utils

# Merger dans un sous-dossier
git merge -s subtree --allow-unrelated-histories lib-utils/main

Pour les projets multi-repos, préférez submodules ou subtree.

Dépannage

Symptôme	Cause probable	Solution
Conflits récurrents à chaque merge	Branche longue divergente	Activez rerere, mergez main plus souvent
--squash puis re-merge crée des conflits	Git ne voit pas les commits déjà intégrés	Supprimez la branche après squash, ou utilisez un merge normal
rerere applique une mauvaise résolution	Résolution enregistrée incorrecte	git rerere forget fichier
-Xours ne résout pas tout	Conflits de suppression/ajout	Résolvez manuellement avec --ours/--theirs par fichier
revert -m 1 ne fonctionne pas	Pas un commit de merge	Utilisez git revert SHA sans -m

Glissez pour voir

À retenir

• git merge --abort pour annuler un merge en conflit
• -Xours/-Xtheirs : résolution automatique en faveur d'un côté (uniquement les conflits)
• --squash : merger sans commit de merge, historique linéaire
• rerere : Git mémorise et rejoue vos résolutions de conflits
• Pour les fichiers binaires : checkout --ours/--theirs par fichier
• N'oubliez pas : -Xours (option) ≠ -s ours (stratégie)

Contrôle de connaissances

Vérifiez que l'essentiel de ce guide est acquis. Les questions portent uniquement sur ce qui vient d'être expliqué ici.

Contrôle de connaissances

Validez vos connaissances avec ce quiz interactif

10 questions

6 min.

70% requis

Informations

• Le chronomètre démarre au clic sur Démarrer
• Questions à choix multiples, vrai/faux et réponses courtes
• Vous pouvez naviguer entre les questions
• Les résultats détaillés sont affichés à la fin

Démarrer le quiz

Lance le quiz et démarre le chronomètre

Pour aller plus loin

• Rechercher dans Git : git log -S et git grep pour retrouver quand une ligne en conflit est apparue.
• Debug : bisect et blame : L'identification du commit qui a introduit la régression révélée par une fusion.
• Plateformes Git : Les garde-fous que les forges ajoutent autour des fusions, revues et branches protégées.

×

📖 Voir la documentation →