Flujo de depuración con diff de texto

Cuando una comparación parece ruidosa o confusa, trata la revisión de diff como depuración: reduce variables, compara la muestra útil más pequeña y elige la herramienta adecuada.

Un flujo práctico

1. Pega el texto original a la izquierda y el modificado a la derecha.
2. Empieza con diff de líneas lado a lado.
3. Lee el resumen de cambios: añadidas, eliminadas, modificadas, inalteradas.
4. Si solo cambiaron unas pocas líneas, cambia a resaltado a nivel de palabra.
5. Si espacios en blanco o mayúsculas crean cambios falsos, activa opciones de ignorar.
6. Si pegaste los lados en orden incorrecto, intercámbialos.
7. Copia el resumen del diff en tu nota, ticket o comentario de revisión.

Cuándo ignorar espacios en blanco o mayúsculas

Activa ignorar espacios en blanco cuando:

• Un archivo tiene espacios finales
• Cambió la indentación pero no los valores
• Copiar/pegar introdujo líneas en blanco extra en los bordes

Activa ignorar mayúsculas cuando:

• Las etiquetas de entorno difieren solo en mayúsculas
• Los nombres de encabezado o valores tipo enum deben tratarse como equivalentes
• Quieres centrarte en contenido semántico, no en formato

No ignores espacios/mayúsculas cuando importen bytes exactos, como entradas HMAC, payloads firmados o rutas sensibles a mayúsculas.

Diff de texto vs diff JSON

Elige con intención:

• Diff de texto: configs, logs, archivos env, salida curl, texto mixto, payloads parciales
• Diff JSON: objetos JSON parseados donde importan rutas de campo y estructura anidada

Si el diff JSON informa muchos cambios pero el diff de texto muestra solo una línea, el problema puede ser orden de claves o formato — no datos de negocio.

Señales habituales de fallo

• Todo parece modificado: comprueba orden de claves, espacios en blanco o si comparaste archivos no relacionados.
• Nada parece modificado pero el comportamiento difiere: compara una muestra más grande o una capa distinta (encabezados, env, cuerpo de respuesta).
• El diff es demasiado grande para el navegador: recorta primero a la sección relevante.

Conclusión clave

Una buena revisión de diff es disciplinada: muestra más pequeña, vista correcta, modo de resaltado correcto, ajustes de ignorar correctos y herramienta de comparación adecuada para la forma de los datos.

El Comparador de diff de texto está diseñado para este flujo: procesamiento local, vistas lado a lado/unificadas, resaltados a nivel de palabra, opciones de ignorar, intercambio y acciones de copiar en un solo espacio de trabajo.