Volver al blog

git diff con dos o tres puntos: qué estás comparando realmente

Serie: Git sin miedo

Quieres ver qué ha cambiado en tu rama antes de abrir la pull request. Ejecutas git diff main..feature y aparecen cambios que tú no has hecho. No es un bug: estás comparando otra cosa.

Dos puntos: las puntas de las dos ramas

git diff main..feature
# equivale a
git diff main feature

Compara el último commit de main con el último de feature. Si main ha avanzado desde que creaste tu rama, esos commits nuevos aparecen como si tu rama los deshiciera, porque feature no los tiene.

Tres puntos: desde el ancestro común

git diff main...feature
# equivale a
git diff $(git merge-base main feature) feature

Busca el commit donde feature se separó de main (el ancestro común, merge-base) y compara desde ahí. Resultado: solo lo que has hecho en tu rama.

Es lo que normalmente quieres para revisar una rama, y es la comparación que usa GitHub al mostrar los cambios de una pull request.

git diff --stat main...feature   # resumen de archivos tocados en tu rama

Cuidado: git log lo usa al revés

Los mismos puntos significan otra cosa en git log:

Comando Qué muestra
git log main..feature commits que están en feature y no en main (lo tuyo)
git log main...feature commits que están en una de las dos, pero no en ambas

Así que para «lo que he hecho en mi rama»:

  • cambios: git diff main...feature (tres puntos)
  • commits: git log main..feature (dos puntos)

Cuándo usar cada uno

  • Tres puntos para revisar tu trabajo o el de otra persona antes del merge.
  • Dos puntos para saber exactamente en qué se diferencian hoy las dos ramas, por ejemplo antes de desplegar una u otra.

Si de esa comparación solo necesitas traerte un archivo concreto, usa git restore --source.