Parfois, des modifications sont indexées pour un commit, mais après réflexion, il apparaît que certaines modifications ne doivent pas être incluses. Heureusement, il est possible de revenir sur les modifications indexées dans Git, garantissant ainsi que vos commits reflètent fidèlement les modifications souhaitées.

Annulation des modifications indexées avec git restore

La commande git restore est un outil puissant pour revenir sur des modifications indexées. Pour annuler les modifications dans des fichiers qui ont été indexés mais pas encore validés, il est possible d'utiliser la commande suivante :

git restore --staged <file>

Où <file> correspond au nom des fichiers ou à leur chemin relatif au répertoire du projet. L'option --staged indique à Git de restaurer les modifications dans la zone de staging. Après l'exécution de cette commande, les modifications dans <file> seront retirées de la zone de staging.

Si vous souhaitez retirer de la zone de staging puis annuler les modifications dans le répertoire de travail, utilisez la commande suivante :

git restore --staged --worktree <file>

Voici une image pour clarifier la procédure :

Exemple de flux de travail

Supposons que vous souhaitiez ajouter une autre ligne avec l'étape suivante de la recette :

Contrairement au chapitre précédent, aucune erreur n'a été commise, donc indexez ce changement :

Cependant, après réflexion avant de valider, il semble que l’ajout de cette ligne au fichier de recette soit inutile. Par conséquent, annuler complètement ce changement. Commencer par vérifier l’état de l’arbre de travail et de la zone de staging :

Ce changement est effectivement indexé, donc exécuter la commande git restore avec les options appropriées pour l’annuler complètement :

Enfin, vérifier que l’arbre de travail et la zone de staging sont propres :