Git cherry-pick vs merge vs rebase: cuándo traer solo un commit

Cherry-pick copia un commit concreto; merge y rebase traen la rama entera. Cuándo usar cada uno, qué duplicados genera cherry-pick y cómo deshacerlo.

Git cherry-pick vs merge vs rebase: cuándo traer solo un commit

Git cherry-pick copia el cambio de un commit concreto (o de unos pocos) a tu rama actual y crea un commit nuevo con otro hash. Merge y rebase, en cambio, traen la rama entera. Si necesitas una sola corrección y no el resto del trabajo, cherry-pick; si quieres todo, merge o rebase.

Para seguir esto solo necesitas saber qué es un commit y una rama. La diferencia entre merge y rebase (qué forma deja cada uno en el historial) ya la tienes en la comparativa entre merge y rebase. Aquí la pregunta es otra: cuánto te traes.

Cherry-pickMergeRebase
Qué traeLos commits que tú eliges, uno a unoToda la ramaToda tu rama, recolocada sobre otra base
Qué creaUn commit nuevo por cada commit copiado, con hash distinto al originalUn commit de fusión (o un fast-forward)Copias de tus commits con hashes nuevos
Relación con el originalGit no lo anota en el commit; solo queda escrito si usas -xLos commits originales entran tal cualLos originales se sustituyen por las copias
Caso típicoHotfix a release, backport, commit en la rama equivocadaIntegrar una feature terminadaPoner tu rama local al día antes de abrir la PR

Qué hace git cherry-pick, con un ejemplo real

Cherry-pick coge el diff que introdujo un commit y lo vuelve a aplicar encima de la rama en la que estás. Lo he probado en un repo de prueba con git 2.43 (los hashes son de ese repo, en el tuyo serán otros). Tengo una rama feature/pagos con tres commits, y solo uno de ellos es un fix que necesito ya en release/1.0:

# Desde la rama que RECIBE el cambio
git switch release/1.0
# Copia solo el fix; -x anota de dónde viene
git cherry-pick -x 28b1fb9
git log -1 --format='%h %s%n%b'
# 8308bb2 fix: evita crash con usuario nulo
# (cherry picked from commit 28b1fb9e897f...)

Fíjate en los dos hashes: el original es 28b1fb9 y la copia es 8308bb2. Mismo cambio, mismo mensaje, commit distinto, porque el padre es otro y el hash de un commit depende de su padre. Los otros dos commits de feature/pagos se quedan donde estaban, sin tocar.

La línea (cherry picked from commit ...) solo aparece porque usé -x; sin esa opción, el commit no guarda ninguna anotación de que es una copia, y la documentación oficial de git cherry-pick recomienda -x justo cuando copias entre ramas públicas, como en un backport.

Cuándo cherry-pick es la herramienta correcta

Cherry-pick encaja cuando quieres un cambio concreto y no quieres el resto de la rama, ni ahora ni después.

Hotfix a una rama de release. El fix nace en tu rama de trabajo, pero esa rama tiene funcionalidades a medias que no pueden llegar a producción. Copias el fix a release/1.0 y la feature sigue su camino normal.

Backport. Corriges un bug en main y necesitas la misma corrección en una versión antigua que sigues manteniendo. Esa rama de mantenimiento no va a recibir nunca todo main, así que copiar el commit es lo único razonable. Aquí -x es casi obligatorio.

Commit en la rama equivocada. Nos pasa a todos: haces un commit en main creyendo que estabas en tu rama. Si aún no lo has subido, lo copias a la rama donde tocaba y lo quitas de main:

git switch feature/registro            # la rama donde debía ir
git cherry-pick c8bbd47                # copia el commit equivocado
git switch main
git reset --hard HEAD~1                # quita el commit de main (solo si NO lo has subido)

Ese reset --hard reescribe main, así que solo vale mientras el commit viva en tu máquina. Si ya lo habías subido, cambia el reset por git revert c8bbd47 en main: deshace el cambio con un commit nuevo sin reescribir la rama compartida (lo ves más abajo, en cómo deshacer un cherry-pick).

Y si la rama ni siquiera existía, no necesitas cherry-pick: git branch feature/registro antes del reset ya la deja apuntando a ese commit.

Cuándo NO usar cherry-pick: si vas a mergear la rama entera

Si tarde o temprano vas a integrar la rama completa, cherry-pick te deja el mismo cambio duplicado. En mi repo de prueba, después de copiar el fix, mergeé feature/pagos entera en una copia de release/1.0. El merge entró sin conflictos, pero mira el grafo:

*   2835ff8 Merge branch 'feature/pagos' into release-merge
|\
| * 1f2a68c pagos: reintentos
| * 28b1fb9 fix: evita crash con usuario nulo
| * 5ca565a añade módulo de pagos
* | 8308bb2 fix: evita crash con usuario nulo
|/
* 44c5f6f commit inicial

Dos commits con el mismo mensaje y hashes distintos. Quien lea ese historial dentro de seis meses no sabrá si son el mismo cambio o dos intentos diferentes.

Y puede ir a peor. Si después del cherry-pick alguien vuelve a tocar esa misma línea en la rama de origen, el merge final da un conflicto sobre un cambio que tú creías ya resuelto. Lo reproduje añadiendo un commit que modificaba la línea del fix: CONFLICT (content): Merge conflict in app.txt. Resuelves el mismo fix dos veces.

Rebase se porta mejor en este caso (si la rama es solo tuya): al rebasear feature/pagos sobre la release, Git avisó con warning: skipped previously applied commit 28b1fb9 y se saltó la copia, porque detecta que ese cambio ya está aplicado. Si quieres entender por qué rebase reaplica commit a commit, lo tienes en cómo funciona git rebase paso a paso.

La regla práctica: si la rama entera va a acabar integrándose, intégrala entera con git merge o rebase y olvídate de copiar commits sueltos.

Cómo ver qué commits ya están copiados

git cherry compara dos ramas por el contenido de cada cambio (su patch-id), no por el hash, así que reconoce las copias aunque tengan otro identificador. Ojo: solo funciona si el cambio quedó idéntico. Si resolviste un conflicto al copiarlo, el diff ya es otro: git cherry lo da como pendiente (+) y rebase tampoco se lo salta. Ahí es donde -x te salva, porque el hash original queda escrito en el mensaje. (La documentación dice que -x solo anota los cherry-picks sin conflictos; en mi prueba con git 2.43 la línea se mantuvo tras resolver uno, pero compruébalo con git log -1.)

git cherry -v --abbrev=7 release/1.0 feature/pagos
# + 5ca565a añade módulo de pagos            (falta en release)
# - 28b1fb9 fix: evita crash con usuario nulo (ya tiene un equivalente)
# + 1f2a68c pagos: reintentos                 (falta en release)

El - marca lo que ya está copiado. git log --oneline --cherry-pick --left-right release/1.0...feature/pagos hace lo mismo desde git log: oculta los pares equivalentes y te deja solo lo que de verdad falta. Antes de un backport grande, esta comprobación te ahorra copiar algo dos veces.

Cómo deshacer un cherry-pick

Depende de en qué punto estés:

  • En mitad de un conflicto: git cherry-pick --abort te devuelve al estado anterior, como si no hubieras empezado.
  • En mitad de un rango, solo ese commit: git cherry-pick --skip descarta el commit que ha dado conflicto y sigue con los demás.
  • Ya hecho, pero solo en local: git reset --hard HEAD~1 quita el commit copiado.
  • Ya subido a una rama compartida: git revert <hash-de-la-copia> crea un commit nuevo que deshace el cambio sin reescribir historia.

La diferencia entre reset y revert, y por qué uno es seguro en ramas compartidas y el otro no, la cuento en git reset vs revert vs restore.

Fuentes

  1. git-cherry-pick, documentación oficial de Git (fuente en el repositorio git/git): -x, -m y rangos.
  2. git-cherry, documentación oficial de Git (fuente en el repositorio git/git): comparación por patch-id y los marcadores +/-.

Preguntas Frecuentes

¿Git cherry-pick mueve el commit o lo copia?

Lo copia. El commit original sigue en su rama y en la tuya aparece uno nuevo con el mismo cambio y otro hash.

¿Puedo hacer cherry-pick de varios commits a la vez?

Sí. Puedes pasar varios hashes seguidos (git cherry-pick a1b2c3d e4f5a6b) o un rango. Ojo con el rango: A..B no incluye A, igual que en git log. En mi prueba, git cherry-pick 5ca565a..1f2a68c se saltó el primer commit y el último falló porque dependía de él. Para incluir A, escribe A^..B.

git cherry-pick 5ca565a^..1f2a68c   # incluye 5ca565a y todo hasta 1f2a68c

¿Qué diferencia hay entre git merge y cherry-pick si solo quiero un fix?

Merge se trae todos los commits de la rama que aún no tienes, no solo el fix. Si la rama lleva trabajo a medias, ese trabajo entra también. Cherry-pick copia únicamente el commit que eliges, a cambio de duplicarlo si algún día mergeas la rama completa.

¿Se puede hacer cherry-pick de un merge commit?

Sin -m, no: Git lo rechaza con error: commit … is a merge but no -m option was given, porque no sabe contra cuál de los dos padres calcular el cambio. La opción -m le indica qué padre tomar como línea principal (-m 1 suele ser la rama en la que se hizo el merge). Si te ves haciéndolo a menudo, probablemente lo que quieres es mergear esa rama.

¿Qué diferencia hay entre git rebase y cherry pick?

Rebase hace, en la práctica, un cherry-pick de cada commit de tu rama sobre la nueva base, todos de una vez y moviendo la rama. Cherry-pick hace lo mismo con los commits que tú eliges y deja tu rama donde estaba. Por eso rebase sirve para poner al día una rama entera y cherry-pick para llevarte un cambio suelto.

Elegir entre cherry-pick, merge y rebase es una decisión de criterio, no de memorizar flags, y se aprende mejor tocando un repo que leyendo. En Git de cero a profesional practicas ramas, integraciones y cómo deshacer errores de forma visual, sin miedo a romper nada.