Saltar al contenido
jungladigital

El álbum: qué hacen git log y git diff

git log hojea el álbum de fotos de tu carpeta; git diff compara dos fotos y marca lo que cambió en rojo y verde, como un examen corregido. Aquí nace el hábito que te deja trabajar con un agente de IA tranquilo: leer antes de guardar.

El comando git diff en verde sobre fondo oscuro: qué hacen git log y git diff

Ya tienes fotos en el álbum desde la parada anterior. Ahora aprendes a mirarlas. Piensa en un examen corregido: lo que tachó el profesor en rojo, lo que agregó en verde, y el resto igual. git hace exactamente eso con tus archivos, y es la herramienta que más vas a agradecer cuando un agente de IA trabaje en tu carpeta, como al cerrar el sendero de Claude Code. Empezamos con un cambio tuyo: el corte sube de 8 a 9 dólares en DATOS.md.

Este artículo se adapta a tu sistema

git diff: el examen corregido

Cambiaste el precio y guardaste el archivo. Antes de la foto, pregúntale a git qué cambió:

Mac
~/barberia
$ git diffdiff --git a/DATOS.md b/DATOS.mdindex da3503e..339ef75 100644--- a/DATOS.md+++ b/DATOS.md@@ -4,7 +4,7 @@ Plantilla: se llena con los datos reales del dueño. ## Servicios y precios-- Corte: 8 dólares+- Corte: 9 dólares - Barba: 5 dólares - Corte + barba: 12 dólares - Niños: 6 dólares

Windows

~\barberia
$ git diffdiff --git a/DATOS.md b/DATOS.mdindex ba8bd05..b8e9c3e 100644--- a/DATOS.md+++ b/DATOS.md@@ -1,4 +1,4 @@ # Datos-- Corte: 8 dolares+- Corte: 9 dolares - Barba: 5 dolares

En tu terminal, el renglón con - sale en rojo y el de +, en verde.


A esta salida se le llama diff. Las cuatro primeras líneas dicen de qué archivo se trata; se leen una vez y se olvidan. El renglón que empieza con @@ dice dónde está el cambio. Lo importante viene después. Un renglón con - adelante es como estaba en la última foto, el tachado en rojo. Uno con + es como está ahora, la corrección en verde. Los renglones sin signo son contexto, para que sepas dónde estás. git no cambia un renglón por partes: lo tacha entero y lo escribe de nuevo, aunque solo haya cambiado un número. Aquí se lee de un vistazo: 8 pasó a 9. Si en tu Windows no ves colores, el - y el + dicen lo mismo.

Lo que ya está sobre la mesa

Pones el cambio sobre la mesa y vuelves a preguntar:

~/barberia
$ git add DATOS.md$ git diff$ git diff --stageddiff --git a/DATOS.md b/DATOS.mdindex da3503e..339ef75 100644--- a/DATOS.md+++ b/DATOS.md@@ -4,7 +4,7 @@ Plantilla: se llena con los datos reales del dueño. ## Servicios y precios-- Corte: 8 dólares+- Corte: 9 dólares - Barba: 5 dólares - Corte + barba: 12 dólares - Niños: 6 dólares$ git commit -m "sube el corte a 9 dólares"[master 1d2939b] sube el corte a 9 dólares 1 file changed, 1 insertion(+), 1 deletion(-)

Después de git add, git diff a secas ya no muestra nada (en Windows, como mucho un aviso de CRLF).


El cambio no desapareció. git diff a secas compara la carpeta con la mesa: muestra lo que todavía no pusiste en la foto. git diff --staged compara la mesa con la última foto: muestra exactamente lo que vas a fotografiar. El primero te sirve mientras trabajas, el segundo justo antes de disparar. Si alguna vez git diff no dice nada y sabes que cambiaste algo, ya sabes dónde buscar: está sobre la mesa. La regla práctica es corta. Antes de cada git commit, un git diff --staged, y lees cada renglón verde.

Auditar al copiloto

Ahora el cambio lo hace Claude. Abriste Claude Code en la carpeta y le pediste: «agrega a PROYECTO.md una sección corta con las formas de pago: efectivo y transferencia». Contestó que agregó la sección «Formas de pago» al final, después del horario. Antes de la foto, compruébalo:

~/barberia
$ git status --short M PROYECTO.md$ git diffdiff --git a/PROYECTO.md b/PROYECTO.mdindex 8e405a0..af08e58 100644--- a/PROYECTO.md+++ b/PROYECTO.md@@ -22,3 +22,7 @@ Un solo archivo index.html que se abre con doble clic y se ve bien en el teléfo ## Horario Martes a sábado, de 9 a 19. Domingo y lunes, cerrado.++## Formas de pago+- Efectivo.+- Transferencia.

Un solo archivo, cuatro renglones verdes, ninguno rojo.


Claude dijo la verdad, y el diff lo prueba: tocó solo PROYECTO.md, no borró nada y no inventó datos. Tres preguntas cada vez que leas un diff del copiloto. ¿Tocó solo lo que le pediste? ¿Borró algo que no debía, como un precio o un teléfono? ¿Escribió un dato que no le diste? Si todo está bien, git add . y la foto, por ejemplo «formas de pago en PROYECTO.md». Si algo no te gusta, no lo fotografíes: en la próxima parada aprendes a descartarlo.

Hojear el álbum: git log

Con la foto de las formas de pago ya sacada, el álbum tiene seis fotos:

~/barberia
$ git logcommit 924a2a38d2a58f2b09be2a9f8fabd936e7cd5f02 (HEAD -> master)Author: Ana Torres <ana@ejemplo.com>Date:   Mon Nov 9 11:08:36 2026 -0500    formas de pago en PROYECTO.mdcommit 1d2939b191ca9bff34d2c797c6901f7108dbe8d7Author: Ana Torres <ana@ejemplo.com>Date:   Mon Nov 9 11:08:36 2026 -0500    sube el corte a 9 dólarescommit 208bb41f11a462fbd9d843a49434b21b94c2b72cAuthor: Ana Torres <ana@ejemplo.com>Date:   Mon Nov 9 11:08:36 2026 -0500    notas sueltascommit 02d43a40beb149e6afbc6009895148bf9ce29381Author: Ana Torres <ana@ejemplo.com>Date:   Mon Nov 9 11:08:36 2026 -0500    horario en PROYECTO.md:

Ese : al final quiere decir que git espera que sigas leyendo. Se sale con q.


Cada foto trae su código completo, quién la firmó, la fecha con la hora y la nota. «HEAD -> master» marca la foto en la que estás parado, la última. Cuando el álbum no cabe en la pantalla, git lo muestra por páginas, igual que un manual: Espacio pasa a la siguiente, las flechas bajan renglón por renglón y q te devuelve a la terminal. En Mac, si bajas, al final aparecen las dos fotos del sendero anterior con la firma que git inventó. Esa q es lo que más se busca la primera vez. En Windows comprueba tú si se detiene igual; si no se detiene, no hace falta la q.

La versión corta: --oneline

Casi siempre te basta con una foto por renglón:

~/barberia
$ git log --oneline924a2a3 (HEAD -> master) formas de pago en PROYECTO.md1d2939b sube el corte a 9 dólares208bb41 notas sueltas02d43a4 horario en PROYECTO.md19e9720 datos reales de la barberíacba69c9 proyecto descrito y archivos de manejo

Seis fotos, seis notas. Como cabe en la pantalla, no hay : ni q.


Aquí se ve por qué la nota importa. Este renglón es lo único que vas a leer de cada foto cuando busques algo, y «sube el corte a 9 dólares» te dice todo sin abrirla. El código corto de siete caracteres te sirve para nombrar una foto en otros comandos. Tus códigos y tus fechas van a ser otros: lo que tiene que coincidir con esta demo es la forma, no los números.

Auditar es leer, no confiar. En la próxima parada, qué hacer cuando lo que leíste no te gusta: git restore y git revert.