Annuler les modifications

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Lorsque vous souhaitez annuler les modifications dans un référentiel Git, commencez par déterminer le type de modifications que vous souhaitez annuler. Vous pouvez, par exemple, souhaiter effectuer les opérations suivantes :

• Ignorez les modifications non validées apportées à un fichier en rétablissant le fichier à sa dernière version validée. Vous pouvez également rétablir un fichier dans une des versions validées.
• Rétablir l’état antérieur d’une branche en la réinitialisant sur une validation précédente.
• Annulez les modifications apportées par une validation partagée en créant une validation inversant les modifications. Comme cette approche ne réécrit pas l’historique de validation existant, elle est appropriée à l'annulation des modifications apportées par les validations envoyées et utilisées par d’autres utilisateurs.
• Modifiez votre dernière validation pour modifier son contenu ou son message. Pour plus d’informations, consultez Comment mettre à jour votre dernière validation.
• Corrigez un problème introduit dans une validation précédente en créant une validation incluant le correctif. Pour plus d’informations, consultez Comment créer une validation.

Dans cet article, vous apprendrez comment :

• Ignorer les modifications non validées d’un fichier
• Rétablir un état antérieur à une branche
• Annuler les modifications apportées par une validation partagée

Ignorer les modifications non validées d’un fichier

Si vous avez apporté des modifications à un fichier sans valider ces modifications, vous pouvez utiliser la validation Git pour abandonner rapidement les modifications et rétablir le fichier dans sa dernière version validée.

Git checkout peut également rétablir un fichier dans une des versions validées, lorsque vous spécifiez l’ID de validation.

Avertissement

Si vous souhaitez éventuellement réappliquer les modifications que Git checkout aurait écartées, envisagez plutôt de lesstocker.

Visual Studio 2022

Visual Studio 2022 offre une expérience de contrôle de version Git à l’aide du menu Git, des modifications Git et des menus contextuels dans l’Explorateur de solutions. Visual Studio 2019 version 16.8 offre également l’interface utilisateur Git de Team Explorer. Pour plus d’informations, consultez l’onglet Visual Studio 2019 - Team Explorer.

Visual Studio prend en charge l'abandon des modifications non validées d'un fichier en rétablissant la dernière version validée du fichier.

Dans la fenêtre Modifications Git, identifiez le fichier avec les modifications que vous souhaitez ignorer. Si le fichier se trouve dans la section Changements indexés, cliquez dessus avec le bouton droit et choisissez Désindexer. Les fichiers désindexés s’affichent dans la section Modifications.

Si le fichier se trouve dans la section Modifications, cliquez dessus avec le bouton droit et choisissez Annuler les modifications pour ignorer toutes les modifications apportées au fichier depuis le dernière validation.

Visual Studio 2019 - Menu Git

Visual Studio 2019 offre une expérience de contrôle de version Git à l’aide du menu Git, des modifications Git et des menus contextuels dans l’Explorateur de solutions.

Visual Studio prend en charge l'abandon des modifications non validées d'un fichier en rétablissant la dernière version validée du fichier.

Dans la fenêtre Modifications Git, identifiez le fichier avec les modifications que vous souhaitez ignorer. Si le fichier se trouve dans la section Changements indexés, cliquez dessus avec le bouton droit et choisissez Désindexer. Les fichiers désindexés s’affichent dans la section Modifications.

Si le fichier se trouve dans la section Modifications, cliquez dessus avec le bouton droit et choisissez Annuler les modifications pour ignorer toutes les modifications apportées au fichier depuis le dernière validation.

Visual Studio 2019 - Team Explorer

Visual Studio prend en charge l'abandon des modifications non validées d'un fichier en rétablissant la dernière version validée du fichier.

Dans la vue Modifications de Team Explorer, identifiez le fichier avec les modifications que vous souhaitez ignorer. Si le fichier se trouve dans la section Changements indexés, cliquez dessus avec le bouton droit et choisissez Désindexer. Les fichiers désindexés s’affichent dans la section Modifications

Si le fichier se trouve dans la section Modifications, cliquez dessus avec le bouton droit et choisissez Annuler les modifications pour ignorer toutes les modifications apportées au fichier depuis le dernière validation.

Ligne de commande Git

Vous pouvez utiliser la commande Git checkout pour ignorer les modifications non validées apportées à un fichier en rétablissant le fichier à sa dernière version validée :

git checkout <file>

Par exemple, git checkout README.md ignore les modifications non validées apportées au fichier README.md.

Git checkout prend également en charge la restauration d’un fichier à une version précédemment validée lorsque vous spécifiez un ID de validation partiel ou complet identifiant une validation de manière unique :

git checkout <commit ID> <file>

Pour plus d’informations concernant la recherche d’un ID de validation, consultez Rechercher un ID de validation.

Notes

L’utilisation de la commande Git checkout pour rétablir un fichier diffère de son utilisation classique, qui consiste à basculer entre les branches. La sortie de la commande checkout vous indique s’il s’agit de basculer entre les branches ou de mettre à jour un fichier, et avertit si vous ne savez pas ce que vous essayez de faire.

Rétablir un état antérieur à une branche

Vous pouvez rétablir un état antérieur d’une branche à l’aide de la réinitialisation Git pour réinitialiser la branche à une validation précédente. Git reset affecte tous les fichiers de tous les dossiers de branche.

Git reset propose quelques options. L’option par défaut consiste à rétablir la branche à une validation précédente, tout en conservant toutes les modifications ultérieures en tant que modifications non validées. Une autre option consiste à rétablir une branche à une validation précédente en ignorant toutes les modifications apportées à tous les fichiers de branche depuis cette validation.

Avertissement

Ne réinitialisez pas une branche à une validation antérieure à la dernière validation si cette dernière a été transmise et partagée avec d’autres personnes. Dans ce cas, l’historique de votre branche locale ne correspondra plus à l’historique de la branche distante. Pour les branches partagées, consultez Annuler les modifications apportées par une validation partagée.

Visual Studio 2022

1. Dans la barre de menus, choisissez Git > Afficher l’historique de la branche pour ouvrir l’onglet Historique de la branche actuelle.

   

2. Sous l’onglet Historique de la branche actuelle, cliquez avec le bouton droit sur la validation que vous souhaitez réinitialiser, puis choisissez Réinitialiser > Supprimer les modifications (--en dur) pour réinitialiser la branche sur la validation sélectionnée et supprimer toutes les modifications apportées à tous les fichiers de branche depuis cette validation. Vous pouvez également choisir Réinitialiser > conserver les modifications (--mixte) pour réinitialiser la branche sur la validation sélectionnée et conserver toutes les modifications suivantes en tant que modifications désindexées.

   

Visual Studio 2019 - Menu Git

1. Dans la barre de menus, choisissez Git > Afficher l’historique de la branche pour ouvrir l’onglet Historique de la branche actuelle.

   

2. Sous l’onglet Historique de la branche actuelle, cliquez avec le bouton droit sur la validation que vous souhaitez réinitialiser, puis choisissez Réinitialiser > Supprimer les modifications (--en dur) pour réinitialiser la branche sur la validation sélectionnée et supprimer toutes les modifications apportées à tous les fichiers de branche depuis cette validation. Vous pouvez également choisir Réinitialiser > conserver les modifications (--mixte) pour réinitialiser la branche sur la validation sélectionnée et conserver toutes les modifications suivantes en tant que modifications désindexées.

   

Visual Studio 2019 - Team Explorer

1. Dans l’affichage Modifications de Team Explorer, choisissez Actions > Afficher l’historique pour ouvrir l’onglet Historique de la branche actuelle.

   

2. Sous l’onglet Historique de la branche actuelle, cliquez avec le bouton droit sur la validation que vous souhaitez réinitialiser, puis choisissez Réinitialiser > Supprimer les modifications (--en dur) pour réinitialiser la branche sur la validation sélectionnée et supprimer toutes les modifications apportées à tous les fichiers de branche depuis cette validation. Vous pouvez également choisir Réinitialiser > conserver les modifications (--mixte) pour réinitialiser la branche sur la validation sélectionnée et conserver toutes les modifications suivantes en tant que modifications désindexées.

   

Ligne de commande Git

Vous pouvez utiliser Git reset pour rétablir l’état d’une branche dans une validation antérieure. La commande Git reset peut être utilisée avec différents indicateurs :

• L’indicateur --hard indique à Git de réinitialiser la branche sur la validation spécifiée et d’ignorer toutes les modifications suivantes. Soyez prudent avec cette option, puisque vous pouvez perdre votre travail en l’utilisant.
• L’indicateur --mixed indique à Git de réinitialiser la branche sur la validation spécifiée, mais de conserver toutes les modifications ultérieures en tant que modifications désindexées. Cette option est celle par défaut.
• L’indicateur --soft indique à Git de réinitialiser la branche sur la validation spécifiée, mais de conserver toutes les modifications ultérieures en tant que modifications indexées et désindexées selon leur état précédent.

Une utilisation courante de Git reset est l’option --hard ignorant toutes les modifications non validées dans tous les fichiers depuis la dernière validation :

git reset --hard

Pour réinitialiser matériellement une branche à une validation différente de la dernière validation, spécifiez l’ID de validation ou un ID de validation partiel identifiant de manière unique la validation :

git reset --hard <commit ID> 

Pour plus d’informations concernant la recherche d’un ID de validation, consultez Rechercher un ID de validation.

Annuler les modifications apportées par une validation partagée

Vous pouvez annuler les modifications apportées par une validation à l’aide de restaurer Git pour créer une validation annulant ces modifications. Git revert ne supprime pas la validation d’origine. Cette approche permet d’annuler les modifications apportées par une validation partagée, puisque Git revert ne modifie pas l’historique de validation précédent, si bien que les historiques des branches locales et distantes coïncident toujours.

Visual Studio 2022

1. Dans la barre de menus, choisissez Git > Afficher l’historique de la branche pour ouvrir l’onglet Historique de la branche actuelle.

   

2. Dans l’onglet Historique de la branche actuelle, cliquez avec le bouton droit sur la validation à rétablir et choisissez Rétablir pour créer une validation annulant les modifications apportées par la validation sélectionnée.

   

Visual Studio 2019 - Menu Git

1. Dans la barre de menus, choisissez Git > Afficher l’historique de la branche pour ouvrir l’onglet Historique de la branche actuelle.

   

2. Dans l’onglet Historique de la branche actuelle, cliquez avec le bouton droit sur la validation à rétablir et choisissez Rétablir pour créer une validation annulant les modifications apportées par la validation sélectionnée.

   

Visual Studio 2019 - Team Explorer

1. Dans l’affichage Modifications de Team Explorer, choisissez Actions > Afficher l’historique pour ouvrir l’onglet Historique de la branche actuelle.

   

2. Dans l’onglet Historique de la branche actuelle, cliquez avec le bouton droit sur la validation à rétablir et choisissez Rétablir pour créer une validation annulant les modifications apportées par la validation sélectionnée.

   

Ligne de commande Git

Vous pouvez utiliser la commande Git revert pour annuler les modifications apportées par une validation et créer une validation avec les modifications inversées. La validation dont les modifications ont été inversées reste dans l’historique Git.

git revert <commit ID>

Si l’opération de restauration réussit, Git ouvre une fenêtre d’éditeur vous invitant à insérer un message de validation pour la nouvelle validation.

Git vous informera des conflits éventuels lors du processus de restauration. Vous pouvez résoudre les conflits, puis exécuter git revert --continue, ou exécuter git revert --abort pour annuler le processus de restauration.

Rechercher un ID de validation

Vous pouvez utiliser la commande Git log pour obtenir l’ID d’une validation. L’indicateur --oneline abrège la sortie.

git log --oneline <branch>

La commande Git log répertorie tout d’abord les validations les plus récentes, en commençant par la validation à l’extrémité de la branche spécifiée (la branche actuelle si elle n’est pas spécifiée), puis remonte vers les validations antérieures. Chaque ID de validation dans la sortie abrégée représente une somme de contrôle SHA-1 partielle identifiant de manière unique la validation. Par exemple, git log --oneline main peut générer :

e745d06 (HEAD -> main) Add a test initialization class
31da50b Add network switch test
0c14391 Add readme file
32e3946 Add project files.

Étapes suivantes

Vérifier l’historique

Articles connexes

• Nouveautés dans les référentiels Git ? En savoir plus
• Enregistrer votre travail avec des validations