Git log: enumerar y encontrar los commit de un proyecto

git log te permite visualizar y filtrar todos los commits de un proyecto. Si usas distintas especificaciones, podrás conseguir resultados incluso mejores.

El comando git commit es de los primeros que se enseñan en cualquier tutorial de Git, porque permite hacer instantáneas del estado actual del trabajo y guardar los cambios. Esto resulta de gran importancia en los proyectos de mayor envergadura 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 herramienta fundamental para trabajar con el sistema de control de versiones. En concreto, permite enumerar, filtrar y buscar commit según cambios específicos. Mientras que git status sirve para buscar en el directorio 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 especificas nada, el comando solo enumera todos los commit de tu proyecto en orden cronológico inverso, y puedes ir revisando paso a paso desde el commit más reciente hasta las instantáneas más antiguas. Entre otras cosas, te permite ver la fecha, el nombre y la dirección de correo electrónico del usuario en cuestión.

Esta función sirve básicamente para obtener una visión general del proyecto en el que trabajas. Si estableces parámetros de búsqueda, Git te permite obtener resultados de búsqueda precisos, algo que es especialmente útil si trabajas en un proyecto extenso. Hemos recopilado las opciones más importantes en una tabla que puedes utilizar, además del siempre útil resumen de Git descargable en PDF.

También tienes la opción de combinar diferentes 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 específico 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, supongamos que solo deben considerarse los commit del mismo autor y de otro colaborador entre septiembre y octubre de 2021. Los commit solo pueden tener cambios en el directorio de texto y no ser fusiones. El código correspondiente tiene entonces el siguiente aspecto:

Con pretty, puedes precisar el formato de la visualización de git log. Estos son algunos de los formatos más usados:

• oneline: muestra toda la informació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 información en formato de correo electrónico.
• raw: enumera los commit exactamente como se realizaron.
• format: te permite formatear el texto con precisión según tus propias necesidades; por ejemplo, puedes presentar la información importante en forma de frase, incluir párrafos o especificar un determinado orden de la información.

En la práctica, git log es una herramienta importante para tener una visión general de tu proyecto y filtrar cierta informació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 determinadas tareas, sino que también es adecuado para identificar fuentes de errores.