Cómo mejorar la legibilidad de git diff con diff-so-fancy

Leer los diff de Git en bruto puede ser agotador. La salida estándar es densa, a menudo llena de signos más y menos, y difícil de escanear rápidamente. Si revisas cambios con frecuencia, hacer que los diffs sean más legibles puede ahorrarte tiempo y ayudarte a detectar problemas más rápido.

En este artículo, te mostraremos cómo mejorar la legibilidad de Git diff usando diff-so-fancy — una herramienta diseñada para hacer que los diffs sean más agradables a la vista.

Por qué importa la legibilidad de Git diff

Cuando ejecutas git diff, Git muestra los cambios con símbolos como + y - al comienzo de las líneas. Aunque es funcional, puede ser visualmente duro, especialmente para cambios grandes de código.

Los diffs difíciles de leer pueden causar errores no detectados, revisiones de código más lentas y fatiga mental. Mejorar la forma en que Git muestra los diffs es un pequeño cambio con un gran beneficio en la productividad diaria.

Lectura relacionada: Cómo crear y usar alias de Git para un flujo de trabajo más rápido

¿Qué es diff-so-fancy?

diff-so-fancy es una pequeña utilidad que toma la salida de Git diff y la formatea para una mejor legibilidad. Elimina marcadores extras, resalta los cambios más claramente y estructura la salida para que puedas revisar el código más rápido.

Mejoras clave:

• Adiciones y eliminaciones más claras
• Palabras cambiadas dentro de líneas enfatizadas
• Encabezados de sección más limpios
• Agrupación de bloques más fácil de escanear

Cómo instalar diff-so-fancy

Puedes instalar diff-so-fancy fácilmente a través de gestores de paquetes comunes.

En macOS con Homebrew:

brew install diff-so-fancy

En Ubuntu o distribuciones basadas en Debian:

sudo apt install diff-so-fancy

O clonarlo directamente desde GitHub:

git clone https://github.com/so-fancy/diff-so-fancy.git

Asegúrate de que diff-so-fancy esté en tu path del sistema después de la instalación.

Cómo configurar Git para usar diff-so-fancy

Una vez instalado, necesitas indicarle a Git que canalice los diffs a través de diff-so-fancy.

Configúralo con los siguientes comandos de configuración de Git:

git config --global core.pager "diff-so-fancy | less --tabs=4 -RFX"
git config --global interactive.diffFilter "diff-so-fancy --patch"

Esta configuración:

• Canaliza todos los diffs a través de diff-so-fancy
• Mantiene intacta la salida de color
• Hace que el comportamiento de desplazamiento en less sea limpio y receptivo

También puedes crear un alias de Git si prefieres llamarlo manualmente. Ejemplo:

git config --global alias.dsf "!git diff --color | diff-so-fancy"

Ahora puedes ejecutar git dsf en cualquier momento para ver un diff más elegante.

Antes y después: viendo la diferencia

Salida estándar de git diff:

- old line of code
+ new line of code

Con diff-so-fancy:

• Solo se resaltan las partes cambiadas de una línea
• Los nombres de archivo y encabezados de sección son más fáciles de escanear
• Los cambios están estructurados de una manera que sigue naturalmente tu mirada

Esto te ayuda a entender rápidamente qué cambió, sin ruido adicional.

Conclusión

Las pequeñas mejoras en tu flujo de trabajo diario con Git se acumulan con el tiempo. Configurar Git con diff-so-fancy hace que tus diffs sean más fáciles de leer, las revisiones más rápidas y los errores menos probables. Si te gustó esta mejora, también podrías encontrar valor en Usar atajos de URL de Git para acelerar la clonación de repositorios.

Preguntas frecuentes