Qué hace la impresión bonita a su JSON
El JSON minificado empaqueta todos los datos en una sola línea para ahorrar bytes — ideal para la transmisión en red pero ilegible para los humanos. La impresión bonita es lo contrario: re-serializa la estructura de datos analizada con saltos de línea e indentación consistentes, de modo que cada par clave-valor y elemento de array aparece en su propia línea, anidado a la profundidad correcta.
Nuestro formateador analiza la entrada primero — lo que significa que detecta errores de sintaxis antes de intentar formatear — y luego re-serializa usando su estilo de indentación elegido (2 espacios, 4 espacios o un carácter de tabulación). El resultado es determinista: la misma entrada siempre produce la misma salida formateada independientemente del espacio en blanco original.
Más allá de la legibilidad, la impresión bonita es una forma ligera de normalización. Las claves dentro de cada objeto permanecen en su orden original, pero todos los espacios en blanco superfluos se eliminan y luego se vuelven a añadir uniformemente. Esto hace que las diferencias línea por línea entre dos archivos JSON sean mucho más limpias.
Estilos de indentación y cuándo usar cada uno
La indentación de dos espacios es el estilo más común en bases de código JavaScript y TypeScript y en la mayoría de los ejemplos de JSON Schema. Evita que las estructuras profundamente anidadas se desplacen demasiado a la derecha en terminales de 80 caracteres de ancho.
La indentación de cuatro espacios es el estándar en las comunidades Python (PEP 8) y Java. Si su JSON se incrustará en un proyecto Python o Java y se revisará junto a otros archivos, cuatro espacios lo hace visualmente consistente.
La indentación por tabulación permite que el editor de cada desarrollador muestre la indentación con su ancho preferido. Prefiera las tabulaciones cuando su repositorio ya usa tabulaciones para otros tipos de archivos, para mantener el estilo consistente.
Impresión bonita vs. Formato vs. Validación vs. Minificación
La impresión bonita y el formateo son la misma operación: añadir espacio en blanco para legibilidad. La validación comprueba si el JSON es sintácticamente correcto y, opcionalmente, si coincide con un esquema — no modifica los datos. La minificación es lo opuesto de la impresión bonita: elimina todo el espacio en blanco no significativo para reducir el tamaño del archivo.
Use la impresión bonita cuando reciba una respuesta de API, una entrada de registro o un blob de configuración difícil de leer en su forma minificada. Use la minificación antes de incrustar JSON en una página HTML de producción. Use la validación para confirmar que los datos son correctos antes de procesarlos.
Para archivos JSON muy grandes (cientos de megabytes), las herramientas basadas en el navegador pueden ser lentas. En esos casos, use herramientas de línea de comandos: python -m json.tool o jq . en macOS/Linux.