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

Retour à l’état exact d’avant le git merge. Aucune modification n’est perdue.

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).

Stratégies de résolution des conflits

`-Xours` et `-Xtheirs`

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é

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.

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é

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 REsolution” — 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

Un conflit survient et vous le résolvez manuellement.
Git enregistre la résolution dans .git/rr-cache/.
Plus tard, le même conflit sur les mêmes lignes se reproduit (rebase, merge d’une autre branche…).
Git applique automatiquement la résolution enregistrée.
```
Resolved 'src/config.py' using previous resolution.
```

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

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 :

*.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`

À 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)

Prochaines étapes

Debug avec bisect et blame Localisez une régression par recherche dichotomique.

Réécrire l'historique Rebase interactif, squash, fixup, filter-repo.

Submodules Intégrez des dépôts externes dans votre projet.