Parfois, des modifications sont indexées pour un commit, mais après réflexion, il s'avère 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 prévues.

Annulation des modifications indexées avec git restore

La commande git restore est un outil puissant pour revenir sur les modifications indexées. Pour annuler les modifications dans des fichiers qui ont été indexés mais pas encore validés, vous pouvez 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 d'index. Après l'exécution de cette commande, les modifications dans <file> seront retirées de l'index.

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

git restore --staged --worktree <file>

Voici une image pour clarifier la situation :

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 ajoutez cette modification à la zone de staging :

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'arborescence de travail et de la zone de préparation :

Cette modification est effectivement indexée, 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 :