Git diff – Cómo comparar cambios paso a paso

Git diff es el comando que te permite visualizar exactamente qué cambió en tus archivos antes de crear un nuevo commit. Aprender a utilizarlo te ayudará a detectar errores, revisar cada modificación con detalle y mantener un historial de cambios mucho más limpio y organizado. En esta guía descubrirás cómo funciona y cómo aprovecharlo paso a paso.

1. Introducción

Hasta este punto del curso ya aprendimos a trabajar con el flujo básico de Git. Primero vimos cómo instalar Git y realizar la configuración inicial. Luego aprendimos a crear un repositorio con git init, agregar archivos con git add, guardar versiones mediante git commit y comprobar el estado del proyecto utilizando git status.

Gracias a estos comandos ya somos capaces de crear un historial de versiones de nuestro proyecto. Sin embargo, antes de guardar una nueva versión, existe una pregunta muy importante que deberíamos hacernos:

¿Qué cambios hice exactamente desde el último commit?

Es aquí donde entra en juego Git Diff, una de las herramientas más útiles de Git.

Con git diff podemos comparar archivos y visualizar línea por línea qué fue agregado, eliminado o modificado antes de crear un nuevo commit. Esto nos ayuda a detectar errores, revisar nuestro trabajo y asegurarnos de que solamente estamos guardando los cambios que realmente queremos conservar.

A lo largo de este artículo aprenderás qué es git diff, cómo utilizarlo desde la terminal y desde Visual Studio Code, además de conocer distintos ejemplos reales donde este comando resulta indispensable.

2. ¿Qué es y para qué sirve Git Diff?

git diff es el comando encargado de comparar cambios entre distintas versiones de un archivo o entre diferentes estados del repositorio.

Su función principal consiste en mostrar exactamente qué líneas fueron modificadas, eliminadas o agregadas.

En otras palabras, Git no solamente sabe que un archivo cambió, sino que también puede indicar qué cambió dentro del archivo.

Por ejemplo, si modificamos un archivo HTML agregando un nuevo botón o cambiando un título, git diff mostrará exactamente esas líneas modificadas.

Gracias a ello podemos revisar nuestro trabajo antes de realizar un nuevo commit.

3. ¿Por qué es importante usar Git Diff?

Muchos principiantes realizan cambios y ejecutan directamente:

git add .
git commit -m "Actualización"Lenguaje del código: JavaScript (javascript)

Aunque esto funciona, no siempre es una buena práctica.

Antes de guardar una nueva versión conviene revisar exactamente qué estamos enviando al repositorio.

Al utilizar git diff podemos:

• Detectar errores antes del commit.
• Revisar cambios realizados hace varios minutos u horas.
• Evitar guardar modificaciones accidentales.
• Comprobar que solo modificamos el archivo esperado.
• Ver exactamente qué líneas fueron agregadas o eliminadas.

Por esta razón, muchos desarrolladores ejecutan siempre el siguiente flujo de trabajo:

Editar archivos
       ↓
git status
       ↓
git diff
       ↓
git add
       ↓
git commit

Este pequeño paso evita una enorme cantidad de errores.

4. ¿Cómo funciona Git Diff?

Cuando ejecutamos:

git diff

Git compara:

• El último commit (HEAD)
• Contra los cambios que todavía no fueron agregados al Staging Area.

Es decir, compara:

Último Commit
        │
        ▼
Archivo actual

Y muestra únicamente las diferencias.

No modifica ningún archivo.

No elimina información.

No crea versiones nuevas.

Simplemente realiza una comparación.

5. ¿Cómo interpretar el resultado de Git Diff?

Cuando ejecutamos git diff veremos una salida similar a la siguiente:

<h1>Hola Git</h1>

↓

<h1>Hola Git</h1>
<p>Bienvenidos al curso de Git.</p>Lenguaje del código: HTML, XML (xml)

Git también utiliza algunos símbolos especiales.

Por ejemplo:

+ <p>Bienvenidos al curso de Git.</p>Lenguaje del código: HTML, XML (xml)

El símbolo + indica que esa línea fue agregada.

Si vemos algo como:

- <h1>Hola Git</h1>Lenguaje del código: HTML, XML (xml)

El símbolo – significa que esa línea fue eliminada.

Cuando una línea aparece eliminada y otra agregada, simplemente significa que fue modificada.

6. ¿Cómo usarlo desde la terminal de VS Code?

Supongamos que tenemos este archivo:

<h1>Hola Git</h1>Lenguaje del código: HTML, XML (xml)

Guardamos esta versión utilizando:

git add .
git commit -m "Primer commit"Lenguaje del código: JavaScript (javascript)

Ahora modificamos el archivo.

Queda así:

<h1>Hola Git</h1>

<p>Curso completo de Git.</p>Lenguaje del código: HTML, XML (xml)

Todavía no ejecutamos git add.

Ahora escribimos:

git diff

Git mostrará únicamente la nueva línea agregada.

De esta forma podemos revisar el cambio antes de almacenarlo definitivamente.

6.1. Paso a paso como hacerlo

Paso 1

Modificar uno o más archivos.

Paso 2

Guardar los archivos.

Paso 3

Abrir la terminal.

Paso 4

Ejecutar:

git diff

Paso 5

Leer cuidadosamente todas las diferencias mostradas por Git.

Paso 6

Si todo está correcto:

git add .
git commit -m "Descripción del cambio"Lenguaje del código: JavaScript (javascript)

7. ¿Cómo usarlo sin utilizar la terminal?

Visual Studio Code incorpora una excelente integración con Git.

Ni siquiera es necesario escribir comandos para visualizar las diferencias.

El procedimiento es muy sencillo.

Paso 1

Modificar cualquier archivo del proyecto.

Paso 2

Guardar los cambios.

Paso 3

Abrir el panel Source Control.

Paso 4

Aparecerán los archivos modificados.

Paso 5

• Hacer clic sobre cualquiera de ellos.
• VS Code abrirá automáticamente una comparación visual.
• En una columna veremos la versión anterior.
• En la otra veremos la versión actual.

Además:

• Las líneas agregadas aparecen resaltadas.
• Las líneas eliminadas también aparecen marcadas.
• Las modificaciones se muestran claramente.

Para muchos desarrolladores este método resulta incluso más cómodo que utilizar la terminal.

8. Ejemplo utilizando Git Diff

Imaginemos el siguiente proyecto.

Nuestro archivo index.html contiene:

<h1>Mi sitio web</h1>Lenguaje del código: HTML, XML (xml)

Guardamos esta versión.

git add .
git commit -m "Primer commit"Lenguaje del código: JavaScript (javascript)

Más tarde decidimos agregar un menú.

El archivo queda así:

<h1>Mi sitio web</h1>

<nav>
    <a href="#">Inicio</a>
    <a href="#">Contacto</a>
</nav>Lenguaje del código: HTML, XML (xml)

Sin revisar nada ejecutamos:

git add .
git commit -m "Actualización"Lenguaje del código: JavaScript (javascript)

Todo parece correcto.

Pero…

También habíamos eliminado accidentalmente una línea importante más abajo del documento.

Ese error ya quedó guardado.

En cambio, si antes hubiéramos ejecutado:

git diff

Git habría mostrado exactamente todas las modificaciones realizadas.

Al revisar el resultado habríamos detectado la eliminación accidental y podríamos corregirla antes del commit.

---

¿Cuál fue el beneficio de usar Git Diff?

En este escenario, git diff permitió:

• Detectar un error antes de guardar una nueva versión.
• Evitar crear un commit con información incorrecta.
• Ahorrar tiempo al no tener que revertir cambios posteriormente.
• Tener mayor seguridad sobre el contenido del commit.
• Confirmar que únicamente se agregaron las modificaciones deseadas.

En proyectos grandes, donde pueden modificarse decenas o cientos de líneas, este comando se vuelve prácticamente indispensable.

9. Diferencias entre Git Diff y Git Status

No.

Aunque suelen utilizarse juntos, cumplen funciones completamente diferentes.

Git Status	Git Diff
Indica qué archivos cambiaron.	Muestra exactamente qué cambió dentro de cada archivo.
No muestra el contenido de las modificaciones.	Muestra línea por línea las diferencias.
Es un resumen del estado del repositorio.	Es una comparación detallada de los cambios.

Lo más habitual es ejecutar ambos comandos antes de realizar un commit.

Primero verificamos qué archivos fueron modificados con git status y luego revisamos el contenido de esos cambios mediante git diff.

10. Buenas prácticas al utilizar Git Diff

Incorporar git diff a tu flujo de trabajo te ayudará a crear commits más limpios y precisos. Algunas recomendaciones son:

• Revisar siempre los cambios antes de ejecutar git add.
• Leer con atención las líneas agregadas y eliminadas.
• Corregir cualquier modificación accidental antes de crear el commit.
• Utilizar git status y git diff de forma complementaria.
• Crear commits pequeños y fáciles de entender, después de verificar los cambios con git diff.

11. Resumen

git diff es una herramienta esencial para cualquier desarrollador que trabaje con Git. Mientras que git status nos informa qué archivos fueron modificados, git diff nos permite inspeccionar el contenido exacto de esos cambios antes de guardarlos.

Incorporar este comando a tu rutina de trabajo reduce errores, mejora la calidad de los commits y facilita el seguimiento del historial del proyecto. A medida que avances en Git descubrirás que revisar los cambios antes de cada commit es una práctica casi obligatoria, especialmente cuando trabajas en proyectos grandes o colaborativos.