Actualizado el

git history: el nuevo comando experimental de Git para reescribir commits

Si alguna vez has abierto un rebase interactivo solo para cambiar un commit, git history te puede ahorrar pasos. Es un comando experimental que actúa directamente sobre un commit concreto: le dices qué quieres hacer y Git se encarga del resto.

El rebase interactivo es potente, pero también una de esas partes de Git que muchos developers prefieren no tocar si pueden evitarlo. Por eso este comando me llamó la atención.

Qué versión necesitas

git history llegó en Git 2.54 con reword y split. Git 2.55 añadió fixup y Git 2.56 incorporó drop. Para probar todos los ejemplos de este artículo necesitas Git 2.56 o posterior:

git --version

Corregir un commit anterior con fixup

Imagina este historial:

8d4c2a1 Añade validación al formulario
3b7e910 Crea el formulario de registro

Si un cambio pertenece al commit 3b7e910, prepáralo en el staging y aplícalo a ese commit:

git add src/register-form.js
git history fixup 3b7e910

Git incorpora el cambio al commit elegido y vuelve a crear los posteriores. El mensaje y la autoría del commit corregido se conservan por defecto. Si la operación provoca un conflicto, se cancela.

Cambiar el mensaje con reword

Si el contenido es correcto pero el mensaje no, usa:

git history reword 3b7e910

Git abre el editor con el mensaje actual. El contenido y la autoría del commit no cambian.

Dividir un commit con split

Si un commit mezcla dos cambios independientes, puedes separarlos:

git history split 8d4c2a1

Git te enseña cada hunk y te pregunta si debe pasar al nuevo commit. Al terminar, te pide los mensajes de los dos commits resultantes. Tienes que elegir al menos un hunk y dejar al menos otro en el original; si no, uno de los dos quedaría vacío.

También puedes limitar la selección a ciertos archivos:

git history split 8d4c2a1 -- src/register-form.js

Los archivos que no coincidan con esa ruta permanecen en el commit original.

Eliminar un commit con drop

Desde Git 2.56 puedes quitar un commit del historial y reaplicar sus descendientes sobre el padre:

git history drop 8d4c2a1

No puedes eliminar el commit raíz ni un commit de merge. Si reaplicar los descendientes produce un conflicto, la operación se cancela.

Antes de usarlo

El comando sigue siendo experimental y la documentación oficial avisa de que su comportamiento puede cambiar.

Todas estas operaciones reescriben el historial: el commit que tocas y todos sus descendientes reciben hashes nuevos.

git history no funciona con historiales que contienen merges y, de momento, no ejecuta hooks. Para mover una serie de commits a otra base o editar varios de una vez, sigue usando git rebase.

Por defecto, git history actualiza todas las ramas locales descendientes del commit original. Si solo quieres actualizar la rama actual, añade --update-refs=head:

git history fixup 3b7e910 --update-refs=head

Evita reescribir commits que ya hayas compartido: como cambian los hashes, necesitarías un push forzado y romperías el historial local de tus compañeros. Para empezar, pruébalo en una rama local.

Aun con sus limitaciones, me gusta la dirección: en lugar de editar una lista de pick y recordar qué palabra va en cada línea, dices directamente lo que quieres (corregir, renombrar, dividir o eliminar). Reescribir el historial de Git da un poco menos de miedo.


Comparte


Jorge Baumann aka Baumannzone
Escrito por Jorge Baumann

Jorge Baumann es Senior Software Engineer, especializado en JavaScript. También es creador de contenido y speaker. Vive en Madrid, le encanta el testing, dibujar con CSS y tiene un perro que se llama Rambo.

Conoce más sobre Baumann →

Artículos relacionados

Git Tower: el GUI de Git más potente para macOS y Windows

Git Tower es un cliente de Git de pago para macOS y Windows. Te cuento las tres funciones que más uso: deshacer con un atajo, arrastrar y soltar commits y elegir qué líneas van en cada commit.

Leer artículo→