Guía

Cómo interpretar un diff de texto por líneas

Lee adiciones, eliminaciones y sustituciones, y aprende cómo espacios y saltos de línea afectan una comparación textual.

por Tools in a Tab · Publicado el · Revisado el

Respuesta breve

Un diff por líneas busca una secuencia común entre dos textos y marca lo que desaparece o aparece alrededor. No entiende por sí solo el significado del código o del documento.

-timeout=30
+timeout=45
 retries=3

La primera línea se eliminó, la segunda se añadió y la tercera permanece igual. Una sustitución suele representarse como una eliminación seguida de una adición.

Cómo leer el resultado

  1. Localiza el bloque de líneas iguales para obtener contexto.
  2. Revisa las eliminaciones antes de las adiciones relacionadas.
  3. Comprueba si el cambio es contenido, espacios o salto de línea.
  4. Evalúa el efecto en el formato original.

El comparador de textos ejecuta la comparación localmente y no envía ninguno de los dos documentos.

Cambios invisibles a primera vista

clave=valor y clave=valor no son la misma línea: la segunda termina con un espacio. También pueden diferir tabuladores, mayúsculas, normalización Unicode o finales de línea LF y CRLF. Normalizar automáticamente esas diferencias puede ocultar un problema real, así que debe ser una decisión explícita.

Un diff no sustituye otras comprobaciones

  • Para JSON, valida y formatea antes si quieres comparar estructura legible.
  • Para identidad exacta de bytes o texto normalizado, una huella puede confirmar igualdad, pero no muestra dónde está el cambio.
  • Para código, ejecuta además pruebas: un cambio pequeño puede alterar el comportamiento.
  • Para archivos binarios, una comparación por líneas no es adecuada.

Comparaciones grandes

Los algoritmos de diff necesitan memoria y tiempo según el número de líneas y las diferencias. Divide entradas enormes o usa herramientas especializadas cuando necesites detectar movimientos, palabras internas, sintaxis o historial de versiones. Un diff sencillo es especialmente útil para configuración, salidas de comandos y fragmentos de texto que caben en una revisión humana.

Fuente primaria

La especificación de diff en POSIX define la comparación de archivos y sus formatos de salida normalizados.