Escribí hace poco, implicando la sub utilización que hacemos de Git, al respecto de las acciones que no son comunes. Recientemente debí resolver un problema de integración de cambios en el que, afortunadamente, dispuse de tiempo para poder aprender ciertas cosas. Esta serie es un recuento de ello.

git log es la forma en la que Git, mediante el verbo (o subcomando, como desee verse) log del comando git(1) nos permite visualizar el historial de «confirmaciones» (commits) en un repositorio. Se considera «una herramienta fundamental para entender la evolución del código» al ver quién hizo qué cambios, cuándo se hicieron, y analizar la estructura de las ramas. Si bien es fácil de usar, lo realmente complicado es la interpretación de su salida.

Saber interpretar lo que muestra en pantalla es la clave de ese «quién hizo qué cambios, cuándo, y analizar la estructura de las ramas» pero es algo que debe aprenderse poco a poco. Esta serie de entradas pretende proporcionar algo de ese conocimiento necesario.

Para ver el historial de commits de la rama actual, usar el comando dado a continuación. Nótese que se ha remarcado «rama actual». Un primer error es creer que git log, mostrará todos los commits de todas las ramas; lo cierto es que lo que se mostrará sólo serán los commits más relevantes que traen a la rama activa a su estado actual.

git log

git log mostrará una lista de commits en orden cronológico inverso (el más reciente primero), con detalles como:

• Hash del commit (identificador único de la confirmación)
• Autor del commit
• Fecha y hora del commit
• Mensaje de commit

La salida de git log será similar a lo que se muestra a continuación:

$ git log
commit 3f4e5d9bcd1a2e9a73b5f5e7f2b3c7e6d4e1a2b3
Author: Juan Pérez <juan@example.com>
Date:   Mon Feb 5 10:30:00 2024 -0600

    Agregar funcionalidad de autenticación

commit 7e8c9d0a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q
Author: María Gómez <maria@example.com>
Date:   Sun Feb 4 18:15:23 2024 -0600

    Corregir errores en validación de formularios

Este ejemplo muestra dos entradas de las bitácoras, que pueden todos o al menos los más representativo o importantes que llevan a la rama a su estado actual . Revisaremos esto en una entrega posterior.