HOWTO · Git

Comment créer et utiliser des branches sur Git

Ce tutoriel présente la branche Git. Nous verrons comment les branches Git peuvent vous aider à organiser votre projet.

Sur cette page

Pour créer une branche à partir de votre commit actuel, exécutez git branch feature/login. Cela crée la branche mais vous laisse sur la branche actuelle. Pour la créer et y basculer en une seule étape, utilisez git checkout -b feature/login. Les branches Git sont des pointeurs légers vers des commits, donc l’une ou l’autre commande démarre la nouvelle branche au commit de la branche actuelle, sauf si vous spécifiez un autre point de départ.

Créer et inspecter des branches avec git branch

Exécutez git branch sans argument pour lister les branches locales. Git place un astérisque devant la branche actuellement extraite. L’exemple suivant crée un dépôt temporaire, ajoute un commit, crée une branche thématique et liste les branches locales. L’astérisque marque la branche extraite maintenant. Le shell supprime le dépôt temporaire lorsqu’il se termine.

set -eu
tmp="$(mktemp -d)"
trap 'rm -rf "$tmp"' EXIT
git -C "$tmp" init -q -b main
git -C "$tmp" config user.name Example
git -C "$tmp" config user.email example@example.com
printf 'starter\n' > "$tmp/README.md"
git -C "$tmp" add README.md
git -C "$tmp" commit -qm "Add starter file"
git -C "$tmp" branch feature/login
git -C "$tmp" branch
  feature/login
* main

Créez une branche sans y basculer en exécutant git branch feature/login. Pour renommer la branche actuelle, utilisez git branch -m new-name ; pour renommer une autre branche locale, utilisez git branch -m old-name new-name. L’option -m renomme une branche ; elle ne déplace pas une branche entre des emplacements.

Pour une branche locale fusionnée, git branch -d feature/login demande à Git de la supprimer et refuse lorsque Git la considère comme non fusionnée. Utilisez git branch -D feature/login uniquement lorsque vous avez l’intention de supprimer la référence de la branche locale même si ses commits ne sont peut-être pas fusionnés ailleurs. Supprimer une branche de cette manière n’efface pas les commits qui restent accessibles via une autre référence, mais les commits accessibles uniquement depuis cette branche peuvent finalement être supprimés par le nettoyage de Git.

Ces commandes affectent les branches locales. Pour supprimer une branche du dépôt distant nommé origin, exécutez git push origin --delete feature/login. Cela ne supprime pas votre branche locale ; supprimez-la séparément si nécessaire.

Créer une branche avec git checkout -b et y basculer

Utilisez git checkout existing-branch pour basculer vers une branche qui existe déjà. Utilisez git checkout -b feature/login pour créer une nouvelle branche au commit actuel et y basculer immédiatement. Si le nom existe déjà, Git signale qu’il ne peut pas créer la branche ; choisissez un autre nom ou basculez vers la branche existante.

Les modifications non validées restent dans l’arbre de travail lorsque vous changez de branche si elles peuvent être transportées en toute sécurité. Git ne valide pas ces modifications et ne les enregistre pas exclusivement sur la nouvelle branche. Elles restent non validées et peuvent apparaître sur la branche vers laquelle vous basculez. Si le basculement devait écraser une modification, Git s’arrête et vous demande de résoudre d’abord le conflit. Validez le travail ou utilisez git stash avant de basculer lorsque vous devez le garder séparé.

Après le basculement, exécutez git status pour confirmer la branche actuelle et voir quels fichiers restent modifiés ou non suivis. Par exemple, après git checkout -b feature/login, git status devrait identifier feature/login ; toutes les modifications compatibles apparaissent toujours comme des changements de l’arbre de travail jusqu’à ce que vous les validiez, les mettiez dans un stash ou les abandonniez.