Aller au contenu principal

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.

GitQuest
Démo

Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le

Historique

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 branche

Basculer sur une branche existante

git checkout -b nouvelle-branche

Créer et basculer sur une nouvelle branche

git checkout -- fichier

Restaurer 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.

Historique mais toujours fonctionnel

switch

Uniquement pour changer de branche. Plus clair et plus sûr.

Recommandé depuis Git 2.23

restore

Uniquement pour restaurer des fichiers. Remplace checkout -- fichier.

Recommandé depuis Git 2.23

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

A

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.