Git cherry-pick : La précision chirurgicale

Vous en avez marre de fusionner des branches entières alors que vous ne voulez parfois qu'un seul changement ? Vous avez oublié un commit dans une pull request et vous ne voulez pas tout re-merger ? La solution existe : git cherry-pick !

Cette commande Git permet d'appliquer un commit spécifique depuis une branche vers une autre, sans avoir à merger l'intégralité de la branche source. C'est comme cueillir une cerise 🍒 dans un arbre Git 🌳 sans prendre tout l'arbre !

Qu'est-ce que git cherry-pick ?

git cherry-pick est une commande Git qui permet de copier un ou plusieurs commits d'une branche vers une autre. Contrairement à git merge qui fusionne l'historique complet de deux branches, cherry-pick applique uniquement les modifications introduites par un commit précis.

Syntaxe de base

# Récupérer les derniers commits du remote
git fetch origin

# Visualiser les modifications d'un commit avant de l'appliquer
git show abc123d

# Appliquer un commit spécifique sur la branche actuelle
git cherry-pick abc123d

# Appliquer plusieurs commits en une seule commande
git cherry-pick abc123d def456e ghi789f

# Appliquer une plage de commits (abc123d jusqu'à def456e)
git cherry-pick abc123d^..def456e

Note : abc123d représente le hash du commit (identifiant unique). Vous pouvez le trouver avec git log ou git log --oneline.

Pourquoi git cherry-pick est génial ?

git checkout main
git cherry-pick abc123d  # Applique uniquement le correctif
git push origin main

git checkout main
git cherry-pick def456e  # Applique le commit oublié

Workflow complet : Exemple concret

Contexte : Vous travaillez sur une branche feature/new-api. Un collègue a corrigé un bug critique sur develop (commit a1b2c3d), et vous avez besoin de ce correctif dans votre branche sans merger tout develop.

# 1. Récupérer les derniers commits du remote
git fetch origin

# 2. Visualiser le commit avant de l'appliquer (optionnel mais recommandé)
git show a1b2c3d

# 3. Se placer sur votre branche de travail
git checkout feature/new-api

# 4. Appliquer le commit spécifique
git cherry-pick a1b2c3d

# 5. Si tout se passe bien, le commit est appliqué !
# Vous pouvez vérifier avec :
git log --oneline -5

# 6. Pousser votre branche avec le nouveau commit
git push origin feature/new-api

Gérer les conflits avec cherry-pick

Parfois, le commit que vous cherry-pickez entre en conflit avec votre branche actuelle (modifications sur les mêmes lignes de code). Git vous prévient et met le processus en pause.

1. Git signale le conflit

$ git cherry-pick a1b2c3d
error: could not apply a1b2c3d... Fix bug in API
hint: after resolving the conflicts, mark the corrected paths
hint: with 'git add <paths>' or 'git rm <paths>'
hint: and commit the result with 'git cherry-pick --continue'

2. Identifier les fichiers en conflit

git status

# Résultat :
# Unmerged paths:
#   both modified:   src/api.js

3. Résoudre les conflits manuellement

Ouvrez le fichier src/api.js dans votre éditeur. Git marque les conflits avec des marqueurs :

<<<<<<< HEAD
// Votre code actuel
function fetchData() {
  return axios.get('/api/v1/data')
}
=======
// Code du commit cherry-pické
function fetchData() {
  return axios.get('/api/v2/data')
}
>>>>>>> a1b2c3d... Fix bug in API

Choisissez la version correcte (ou combinez les deux), puis supprimez les marqueurs <<<<<<<, =======, >>>>>>>.

4. Continuer le cherry-pick

# Marquer les fichiers comme résolus
git add src/api.js

# Continuer le cherry-pick
git cherry-pick --continue

# Git ouvrira votre éditeur pour confirmer le message de commit
# Sauvegardez et fermez pour finaliser

Options de résolution

• git cherry-pick --continue : Continue après résolution des conflits
• git cherry-pick --abort : Annule complètement le cherry-pick et revient à l'état initial
• git cherry-pick --skip : Ignore ce commit et passe au suivant (si vous cherry-pickez plusieurs commits)

Options avancées de cherry-pick

git cherry-pick -n a1b2c3d
# Modifications appliquées, mais pas encore committées
# Vous pouvez maintenant éditer les fichiers
git add .
git commit -m "Combined changes"

git cherry-pick -e a1b2c3d
# Git ouvrira votre éditeur pour éditer le message

git cherry-pick -s a1b2c3d
# Le commit aura une ligne : Signed-off-by: Votre Nom <email@example.com>

git cherry-pick -m 1 abc123d
# Applique le commit de merge en utilisant la première branche parent

Cas d'usage réels chez VOID

git checkout main
git cherry-pick abc123d  # Commit du correctif uniquement
git push origin main
# Déploiement immédiat en production

git checkout lts/14.x
git cherry-pick def456e ghi789j  # Les 2 commits de la feature
# Adaptation manuelle si nécessaire
git push origin lts/14.x

git checkout develop
git cherry-pick abc123 def456 ghi789  # Les 3 commits critiques
git push origin develop

Bonnes pratiques et conseils

• Toujours visualiser avant : Utilisez git show <hash> pour voir les modifications avant de cherry-picker
• Préférez les commits atomiques : Un commit = une modification logique. Cela facilite le cherry-pick
• Attention aux dépendances : Si un commit dépend d'un autre, cherry-pickez les deux dans l'ordre
• Documentez vos cherry-picks : Ajoutez une note dans le message de commit (ex : (cherry picked from commit abc123))
• Ne cherry-pickez pas trop : Si vous devez cherry-picker plus de 5-10 commits, envisagez un merge ou un rebase
• Testez après cherry-pick : Le commit peut fonctionner sur la branche source mais pas sur la cible (contexte différent)
• Communiquez avec l'équipe : Informez vos collègues quand vous cherry-pickez des commits pour éviter les confusions

Cherry-pick vs Merge vs Rebase

Pièges courants à éviter

Ressources pour approfondir

• Documentation officielle Git : git-scm.com/docs/git-cherry-pick
• Tutoriel Atlassian : atlassian.com/git/tutorials/cherry-pick
• Expertise DevOps VOID : CI/CD, automatisation, workflow Git
• Toutes nos publications : guides et actualités tech

Cet article présente git cherry-pick, une commande native de Git. Les exemples sont basés sur notre expérience quotidienne chez VOID avec des projets Drupal, Next.js et applications web complexes. Informations à jour en 2025.