Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Anatomie d'un conflit

Anatomie d'un conflit

Conflits et commandes de sauvetageintermediaire

Git ne compare pas deux fichiers. Il en compare trois : la base commune et les deux versions qui en descendent.

git merge-base main fonctionnalite   # le dernier commit commun

Avec cette base, la règle devient simple :

Depuis la base… Résultat
un seul côté a changé la région ce côté est pris, sans question
les deux l'ont changée à l'identique pris une fois
les deux l'ont changée différemment conflit

Un conflit n'est donc jamais « Git n'a pas compris ». C'est « deux personnes ont répondu différemment à la même question, et Git refuse de choisir à votre place ».

Lire le fichier

<<<<<<< HEAD
const TVA = 0.20;
=======
const TVA = 0.21;
>>>>>>> fonctionnalite/tva-belge

Entre <<<<<<< et ======= : ce qui était déjà là. Entre ======= et >>>>>>> : ce qui arrive. L'étiquette à droite de chaque marqueur dit d'où vient le bloc — c'est l'information la plus utile de tout le fichier, et c'est celle qu'on ne lit pas.

Résoudre

git status                  # quels fichiers, et où on en est
# … on édite, on supprime les trois marqueurs …
git add facture.js          # « ce fichier est résolu »
git merge --continue        # ou: git rebase --continue

Résoudre n'est pas choisir un camp. C'est écrire la version qui est juste — souvent ni l'une ni l'autre.

Les termes à connaître

Fusion à trois points

Git ne compare pas deux versions mais trois : la base commune et les deux versions qui en descendent. C'est ce qui lui permet de distinguer « cette ligne a été ajoutée » de « cette ligne a été supprimée en face ».

Base de fusion

Le dernier commit commun aux deux branches, trouvé par git merge-base. Tout le raisonnement de la fusion part de là : sans base commune, Git ne saurait pas qui a changé quoi.

Trouver un conflit

Les deux côtés ont modifié la même région d'un même fichier depuis la base. Git refuse d'arbitrer et écrit les deux propositions dans le fichier, encadrées par des marqueurs.

Marqueurs de conflit

Les lignes <<<<<<<, ======= et >>>>>>> insérées par Git. Entre la première et la deuxième se trouve votre version ; entre la deuxième et la troisième, celle qui arrive.

ours / theirs

Les deux côtés d'un conflit. Pendant un merge, « ours » est la branche sur laquelle vous êtes. Pendant un rebase, les rôles s'inversent : « ours » devient la branche sur laquelle vous rejouez.

Étape d'index

Pendant un conflit, l'index contient trois versions du fichier (base, ours, theirs) au lieu d'une. git add les remplace par une seule — c'est exactement ce que veut dire « marquer comme résolu ».

Conflit sémantique

Les deux côtés fusionnent sans marqueur mais le résultat ne compile plus, ou ne fait plus ce qu'il faut. Git compare des lignes, pas du sens : seuls les tests attrapent ce cas.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.