How Git branches work
DébutantDes commits qui pointent vers leurs parents, des branches qui ne sont que des pointeurs vers des commits, HEAD qui pointe vers une branche, et ce qui se passe à la fusion.
Vide
Vide
Spacelecture ou pause←→étape précédente ou suivanteRrevenir au début
Explication
Lecture : 4 min
Sur cette page
Qu'est-ce qu'une branche dans Git ?
Un commit est un instantané de votre projet à un moment donné, avec un message, un auteur et un
pointeur vers le ou les commits qui le précèdent directement, ses . Chaque commit est
nommé par une empreinte de son contenu, comme eb686a5. En suivant les parents depuis n'importe
quel commit, on remonte tout l'historique.
Une branche n'est qu'un nom qui pointe vers un commit. main et feature sont de tout petits
fichiers dans .git qui contiennent chacun l'empreinte d'un commit. Créer une branche ne copie
rien ; cela écrit un nom de plus. Quand vous faites un commit sur une branche, Git crée le nouveau
commit et y déplace le nom de cette branche.
Comment HEAD et les branches bougent-ils quand on travaille ?
- HEAD, c'est là où vous êtes. Il pointe en général vers une branche, pas vers un commit :
« vous êtes sur main ».
git switch featurefait pointer HEAD vers feature et met vos fichiers à jour selon le commit de cette branche. - Un commit ne déplace que la branche désignée par HEAD. Le parent du nouveau commit est celui vers lequel menait HEAD, et cette seule branche avance. Toutes les autres restent exactement où elles étaient.
- HEAD détaché.
git switch --detach eb686a5(ou l'extraction d'un commit) fait pointer HEAD directement vers un commit. Les commits faits là n'appartiennent à aucune branche : créez-en une avecgit switch -c nomavant de partir, sinon ils deviennent difficiles à retrouver.
Quelle différence entre une avance rapide et un commit de fusion ?
Quand vous lancez git merge feature depuis main :
- Avance rapide (fast-forward). Si main n'a aucun commit à lui depuis le départ de feature, l'historique de feature contient déjà celui de main. Git avance simplement main jusqu'au commit de feature. Aucun nouveau commit n'est créé et l'historique reste une ligne droite.
- Commit de fusion. Si les deux branches ont avancé, comme dans la leçon, Git combine les deux séries de changements depuis leur base de fusion et enregistre un nouveau commit à deux parents : le commit où était main (le premier parent) et celui de feature. Si les deux côtés ont modifié les mêmes lignes, Git s'arrête sur un conflit à résoudre d'abord.
Quelles erreurs fait-on souvent avec les branches Git ?
Mini-exemple
Ici, main n'a aucun nouveau commit à lui : fusionner fix est une avance rapide, le pointeur de main
avance simplement jusqu'au commit de fix.
git switch -c fix # create fix and point HEAD at itgit commit -am "Fix footer"git switch maingit merge fix# Updating feb24fc..3c6bda4# Fast-forwardTest rapide
Dans le mini-exemple, que fait git merge fix ?
Pour aller plus loin
Toutes les étapes en texte
- Étape 1:
git initcrée un dépôt vide : le dossier caché .git où vivra l’historique. Il n’y a encore aucun commit.Ligne 1
- Étape 2:
git addplace index.html dans la zone de préparation, prêt pour le prochain commit. Rien n’est encore enregistré.Ligne 2
- Étape 3:
git commitenregistre un instantané des fichiers préparés : le premier commit. Son empreinte, eb686a5, lui sert de nom.Ligne 3
- Étape 4:
Le commit crée aussi main, un pointeur vers lui. HEAD pointe vers main : c’est la branche sur laquelle vous êtes.
Ligne 3
- Étape 5:
git branch featureajoute un second pointeur vers le même commit. Rien n’est copié : une branche n’est qu’un nom pour un commit.Ligne 5
- Étape 6:
HEAD pointe toujours vers main. Créer une branche ne vous y place pas.
Ligne 5
- Étape 7:
git switch featuredéplace HEAD vers feature. Les deux branches pointent vers le même commit : vos fichiers ne changent pas.Ligne 6
- Étape 8:
Le nouveau commit pointe vers son parent, celui où était HEAD. feature, la branche que désigne HEAD, avance jusqu’à lui ; main ne bouge pas.
Lignes 7–8
- Étape 9:
De retour sur main, HEAD pointe à nouveau vers main, et Git remet vos fichiers comme dans eb686a5 : nav.html quitte le dossier.
Ligne 10
- Étape 10:
Le parent de ce commit est lui aussi eb686a5. L’historique s’est séparé : main et feature ont chacun un commit que l’autre n’a pas.
Ligne 11
- Étape 11:
git merge featurecherche d’abord le dernier commit commun aux deux branches, la base de fusion : eb686a5.Ligne 13
- Étape 12:
Les deux côtés ont avancé depuis : Git crée donc un commit de fusion à deux parents, et y déplace main, la branche où vous êtes.
Ligne 13
- Étape 13:
feature n’a pas bougé : il pointe toujours vers 0bc9bff. Son commit fait désormais aussi partie de l’historique de main.
Ligne 13
- Étape 14:
git log --oneline --graphdessine le même historique en texte : chaque commit, ses parents, et où pointent HEAD et les branches.Ligne 14
- Étape 15:
Un commit pointe vers ses parents, une branche vers un commit, et HEAD vers une branche. Faire un commit déplace la branche où se trouve HEAD.