Sélectionner des validations

Que faire si vous n'avez besoin que d'une modification précise provenant d'une branche, et non de toute la branche ? git cherry-pick vous permet d'appliquer directement un seul commit, provenant de n'importe quel endroit de l'historique de votre dépôt, sur votre branche actuelle.

C'est comme cueillir une seule cerise sur un arbre ! Cette opération crée un tout nouveau commit sur votre branche actuelle, qui reproduit les modifications du commit d'origine.

Imaginez que vous travailliez sur une grande branche de fonctionnalité et que vous découvriez qu'une correction de bogue critique que vous y avez réalisée est également nécessaire immédiatement sur votre branche principale de production. Vous ne souhaitez pas encore fusionner toute la branche de fonctionnalité.

C'est le scénario idéal pour cherry-pick. Cette commande vous aide à transférer des modifications isolées sans inclure du travail sans rapport.

La commande fondamentale est simple : git cherry-pick <commit-hash>.

• Commencez par vérifier que vous êtes sur la branche où vous souhaitez appliquer le commit.
• Vous devez ensuite obtenir l'identifiant unique (le hash) du commit que vous souhaitez sélectionner.
• Git créera alors un nouveau commit contenant les mêmes modifications sur votre branche actuelle.

Pour utiliser cherry-pick, vous avez besoin du hash ! Vous pouvez le trouver avec git log.

L'option --oneline est particulièrement utile pour obtenir une vue concise :

Préparons un scénario simple. Nous allons créer une branche main et une branche feature/login. Nous créerons sur feature/login un commit que nous voulons transférer vers main.

Nous voulons transférer le commit « HOTFIX » vers main.

Revenez maintenant sur la branche main et appliquez le commit « HOTFIX ». Supposons que le hash de « HOTFIX: Fix login button styling » soit abcdefg.

Après l'exécution de cette commande, un nouveau commit apparaîtra sur votre branche main avec les mêmes modifications que abcdefg. Utilisez git log --oneline pour l'afficher !

Comme lors d'une fusion, cherry-pick peut provoquer des conflits si les mêmes lignes de code ont été modifiées différemment dans les deux historiques.

• Git interrompra l'opération et marquera les fichiers en conflit.
• Résolvez manuellement les conflits dans les fichiers.
• Ajoutez les fichiers résolus avec git add.
• Terminez avec git cherry-pick --continue.

Vous pouvez effectuer un cherry-pick sur plusieurs commits à la fois.

Pour sélectionner une plage de commits, de hashA jusqu'à, mais sans inclure, hashB :

Cherry-pick est puissant, mais utilisez-le avec discernement.

• Convient pour : les corrections urgentes et le transfert de petites modifications isolées entre des branches sans lien.
• Moins adapté pour : l'intégration régulière de grands ensembles de modifications, car cela peut créer des commits en double et rendre l'historique plus difficile à suivre si vous ne faites pas attention. Préférez la fusion ou le rebase pour intégrer une branche entière.

Vous avez un commit sur votre branche feature/new-design qui corrige un problème critique de style. Vous devez appliquer immédiatement cette correction à votre branche main, sans fusionner toute la branche de fonctionnalité.

Dans cette leçon, nous avons découvert git cherry-pick, une commande utile pour appliquer des commits précis à votre branche actuelle.

• Elle crée un nouveau commit contenant les mêmes modifications sur votre branche cible.
• Elle convient parfaitement aux corrections urgentes ou au transfert de modifications isolées.
• Vous avez besoin du hash du commit, que vous trouverez généralement avec git log --oneline.
• Soyez prêt à résoudre les conflits, comme lors d'une fusion.

La maîtrise de cherry-pick vous donne un contrôle précis sur l'historique de votre projet !