Git log: enumerar y encontrar los commit de un proyecto

git log te permite vi­sua­li­zar y filtrar todos los commits de un proyecto. Si usas distintas es­pe­ci­fi­ca­cio­nes, podrás conseguir re­su­l­ta­dos incluso mejores.

El comando git commit es de los primeros que se enseñan en cualquier tutorial de Git, porque permite hacer in­s­ta­n­tá­neas del estado actual del trabajo y guardar los cambios. Esto resulta de gran im­po­r­ta­n­cia en los proyectos de mayor en­ve­r­ga­du­ra en los que colaboran equipos más grandes que aplican una multitud de commit y generan un historial que puede resultar confuso. Por este motivo, el comando de Git git log es una he­rra­mie­n­ta fu­n­da­me­n­tal para trabajar con el sistema de control de versiones. En concreto, permite enumerar, filtrar y buscar commit según cambios es­pe­cí­fi­cos. Mientras que git status sirve para buscar en el di­re­c­to­rio de trabajo, git log se centra solo en los commit que se han ejecutado.

La sintaxis básica de git log es muy sencilla. Si no es­pe­ci­fi­cas nada, el comando solo enumera todos los commit de tu proyecto en orden cro­no­ló­gi­co inverso, y puedes ir revisando paso a paso desde el commit más reciente hasta las in­s­ta­n­tá­neas más antiguas. Entre otras cosas, te permite ver la fecha, el nombre y la dirección de correo ele­c­tró­ni­co del usuario en cuestión.

Esta función sirve bá­si­ca­me­n­te para obtener una visión general del proyecto en el que trabajas. Si es­ta­ble­ces pa­rá­me­tros de búsqueda, Git te permite obtener re­su­l­ta­dos de búsqueda precisos, algo que es es­pe­cia­l­me­n­te útil si trabajas en un proyecto extenso. Hemos re­co­pi­la­do las opciones más im­po­r­ta­n­tes en una tabla que puedes utilizar, además del siempre útil resumen de Git de­s­ca­r­ga­ble en PDF.

También tienes la opción de combinar di­fe­re­n­tes opciones para realizar una búsqueda aún más precisa. En el siguiente código te mostramos un ejemplo sencillo de un listado muy es­pe­cí­fi­co con git log. Con este comando, puedes ver en detalle solo los commit del usuario Juan Zutano en el archivo de ejemplo.

Para un ejemplo más completo, su­po­n­ga­mos que solo deben co­n­si­de­rar­se los commit del mismo autor y de otro co­la­bo­ra­dor entre se­p­tie­m­bre y octubre de 2021. Los commit solo pueden tener cambios en el di­re­c­to­rio de texto y no ser fusiones. El código co­rre­s­po­n­die­n­te tiene entonces el siguiente aspecto:

Con pretty, puedes precisar el formato de la vi­sua­li­za­ción de git log. Estos son algunos de los formatos más usados:

• oneline: muestra toda la in­fo­r­ma­ción en una línea.
• short: solo enumera el commit y el autor o el autor y el título.
• medium: enumera el commit, el autor, la fecha, el título y el mensaje.
• full: añade el nombre de quien ejecutó el commit.
• fuller: además, indica la fecha del autor y de quien realizó el commit.
• email: muestra la in­fo­r­ma­ción en formato de correo ele­c­tró­ni­co.
• raw: enumera los commit exac­ta­me­n­te como se rea­li­za­ron.
• format: te permite formatear el texto con precisión según tus propias ne­ce­si­da­des; por ejemplo, puedes presentar la in­fo­r­ma­ción im­po­r­ta­n­te en forma de frase, incluir párrafos o es­pe­ci­fi­car un de­te­r­mi­na­do orden de la in­fo­r­ma­ción.

En la práctica, git log es una he­rra­mie­n­ta im­po­r­ta­n­te para tener una visión general de tu proyecto y filtrar cierta in­fo­r­ma­ción. El comando se utiliza a menudo con git diff y así se consigue enumerar los cambios entre dos commit. Esto no solo te muestra cómo ha cambiado tu proyecto a lo largo del tiempo y ver qué miembros del equipo han asumido de­te­r­mi­na­das tareas, sino que también es adecuado para ide­n­ti­fi­car fuentes de errores.