Git checkout : changer de branche ou restaurer
git checkout est la commande historique pour changer de branche, créer des branches et restaurer des fichiers. Aujourd'hui remplacée par switch et restore, elle reste incontournable.
Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le
C'est quoi git checkout ?
git checkout est le couteau suisse de Git : il change de branche, crée des branches et restaure des fichiers. C'est la commande la plus polyvalente mais aussi la plus confuse.
Depuis Git 2.23, elle est remplacée par deux commandes plus claires : git switch pour les branches et git restore pour les fichiers.
Syntaxe de git checkout
git checkout brancheBasculer sur une branche existante
git checkout -b nouvelle-brancheCréer et basculer sur une nouvelle branche
git checkout -- fichierRestaurer un fichier depuis le dernier commit
Git checkout en pratique
Changer de branche ou restaurer des fichiers.
Branches
Fichiers et commits
checkout vs switch vs restore
checkout
Fait tout : branches, fichiers, commits. Polyvalent mais confus.
switch
Uniquement pour changer de branche. Plus clair et plus sûr.
restore
Uniquement pour restaurer des fichiers. Remplace checkout -- fichier.
Erreurs courantes avec git checkout
Se retrouver en detached HEAD
Si tu checkout un commit au lieu d'une branche, tu es en detached HEAD. Crée une branche avec git checkout -b ma-branche pour ne pas perdre ton travail.
Écraser des modifications locales
git checkout -- fichier écrase les modifications non commitées du fichier. C'est irréversible si les modifications n'ont pas été stashées ou commitées.
Confondre branche et fichier
Si une branche et un fichier ont le même nom, utilise -- pour lever l'ambiguïté : git checkout -- fichier.
Fait partie du guide Workflow Branches Git
GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.
Questions sur git checkout
Navigue entre les branches avec GitQuest
Apprends à jongler entre les branches et les commits grâce aux défis interactifs.