Git : Faire un Checkout d'une Branche Distante
Dernière mise à jour
Pour travailler sur une branche qui existe sur le distant mais pas encore sur votre machine, exécutez d'abord git fetch pour que Git la connaisse, puis faites le checkout. Git moderne facilite cela : git switch <branch> crée automatiquement une branche locale qui suit la origin/<branch> correspondante.
Essayez ceci dans le terminal playground - un vrai shell dans votre navigateur, rien à installer.
Syntaxe
| Command | What it does |
|---|---|
git fetch origin | Télécharge les branches du distant |
git switch feature | Crée une feature locale qui suit origin/feature |
git checkout --track origin/feature | Ancienne façon de suivre une branche distante |
git switch -c local origin/feature | Suivez-la sous un nom local différent |
Exemple pratique
Récupérez la branche d'un coéquipier sur votre machine.
| Step | Command | Result |
|---|---|---|
| 1 | git fetch origin | Git prend connaissance de origin/feature |
| 2 | git switch feature | La feature locale est créée, suivant la distante |
| 3 | git pull | Gardez-la synchronisée par la suite |
FAQ git checkout branche distante
Comment faire un checkout d'une branche distante ?
Exécutez d'abord
git fetch origin pour que Git connaisse les branches du distant, puis git switch <branch>. Git moderne voit la origin/<branch> correspondante et crée automatiquement une branche locale qui la suit. Dans l'ancien Git, utilisez git checkout --track origin/<branch>.Pourquoi git switch dit que la branche n'existe pas ?
En général parce que vous n'avez pas encore fait de fetch - Git ne peut créer automatiquement une branche de suivi que s'il connaît déjà la branche distante. Exécutez
git fetch origin (ou git fetch --all) d'abord, puis git switch <branch> fonctionnera.Comment faire un checkout d'une branche distante sous un nom différent ?
Utilisez
git switch -c <localname> origin/<branch> (ou git checkout -b <localname> origin/<branch>). Cela crée une branche locale avec le nom que vous choisissez qui suit la branche distante, pratique quand le nom distant entre en conflit avec une branche locale existante.Quelle est la différence entre fetch et checkout ici ?
git fetch télécharge seulement les branches distantes et met à jour vos références de suivi distant - il ne vous donne pas de branche de travail. Le checkout (via git switch ou git checkout) est ce qui crée la branche locale sur laquelle vous travaillez réellement. Vous faites fetch une fois, puis checkout.Puis-je m'entraîner en ligne ?
Oui. Ouvrez le terminal playground pour exécuter ces commandes dans un vrai shell dans votre navigateur - rien à installer. Le cours Git interactif et gratuit de Coddy couvre également le travail avec les distants étape par étape.
Ressources associées
Plus de commandes Git
