Tema 8 · Inspección

Comparar Diferencias: git diff y git diff --staged

Aprende a leer e interpretar las diferencias de código línea por línea con git diff antes de preparar cambios, y con git diff --staged antes de confirmar un commit definitivo.

¿Para qué sirve git diff?

Antes de hacer un commit, los programadores profesionales nunca confían en su memoria: ejecutan git diff para auditar exactamente qué caracteres, líneas y funciones se agregaron, modificaron o eliminaron.

Los Dos Sabores de git diff

Comando ¿Qué compara exactamente? Momento de uso
git diff Compara tu Directorio de Trabajo contra el Staging Area. Muestra lo que editaste en tus archivos pero que todavía no has agregado con git add. Antes de hacer git add.
git diff --staged (o --cached) Compara el Staging Area contra el Último Commit (HEAD). Muestra exactamente lo que va a entrar en el próximo commit. Justo antes de ejecutar git commit.

Cómo Leer la Salida de git diff

La salida de Git utiliza el formato unificado de diferencias (Unified Diff):

  • Líneas con signo menos ( - en rojo): Código que fue eliminado o reemplazado.
  • Líneas con signo más ( + en verde): Código nuevo que fue añadido.
  • Encabezado de bloque (@@ -12,4 +12,6 @@): Indica el número de línea de inicio y la cantidad de líneas en la versión original vs la nueva.

⚡ Comandos Clave de Comparación de Diferencias

Auditoría de diferencias en archivos específicos, entre ramas y en el área de preparación:

auditar-diferencias.sh
Solo lectura
# 1. Ver todas las diferencias pendientes sin preparar:
git diff

# 2. Ver diferencias de un archivo en particular:
git diff app/controllers/CourseController.php

# 3. Ver lo que YA está en el Staging Area listo para confirmarse:
git diff --staged

# 4. Ver solo los nombres de los archivos que cambiaron (sin el código):
git diff --stat

# 5. Comparar las diferencias entre dos ramas:
git diff main..develop
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Manual Completo de Git & GitHub Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.