logo
GeekFormat

Formateo JSON

Sin contenido aún

preview.json
Listo

Herramienta de formateo JSON en línea gratuita. Admite embellecimiento, validación, compresión y edición visual en vista de árbol JSON. Con detección de errores de sintaxis integrada y reparación automática. Admite conversión de código a 13 lenguajes de programación (TypeScript/Java/Python/Go/Rust/Swift/Kotlin/C#/C++/PHP/MySQL/YAML/XML). Ideal para depuración de API, verificación de configuración y lectura de registros.

Relacionado

Casos de uso

  • El JSON de una línea de respuestas de API debe embellecerse en estructura legible para facilitar la resolución de problemas
  • Los archivos de configuración y campos de registro deben formatearse antes del procesamiento posterior
  • Validación rápida de validez JSON y compresión de tamaño durante la depuración de desarrollo
  • Necesidad de convertir JSON en estructuras de código como interfaces TypeScript, clases Java o diccionarios Python
  • Al comparar dos respuestas de API, ordenar primero por clave y luego verificar diferencias campo por campo
  • Estructurar estructuras anidadas complejas de API de terceros con vista de árbol o mapa mental para comprender rápidamente la jerarquía
  • Desplegar registros de seguimiento y datos Webhook comprimidos para lectura y localización de campos anómalos
  • Formatear el JSON compacto en variables de entorno locales o configuraciones para modificación, luego recomprimir para reescritura

Características

  • Embellecimiento JSON más intuitivo: organiza rápidamente los datos de una línea en estructura jerárquica legible, indentación conmutable entre 2/4 espacios o Tab
  • Admite validación y compresión: detección en tiempo real de errores de sintaxis con indicación precisa de posición, compresión con un clic a la una línea más compacta
  • Conversión de código a 13 lenguajes: generación con un clic de TypeScript/Java/Python/Go/Rust/Swift/Kotlin/C#/C++/PHP/MySQL/YAML/XML
  • Edición visual en vista de árbol JSON: reducir/expandir nodos, visualizar y modificar intuitivamente estructuras profundamente anidadas
  • Vista de mapa mental: presentación de relaciones padre-hijo de objetos/matrices como conexiones de nodos, ideal para estructurar estructuras complejas
  • Ordenación de claves: reordenación de claves de objeto en orden alfabético ascendente/descendente, práctico para comparar diferencias y estandarizar el orden de campos
  • Procesamiento fluido de archivos grandes: desplazamiento virtual + análisis en segundo plano Web Worker, varios MB de JSON sin ralentizaciones
  • Privacidad y seguridad: ejecución completamente local en el navegador, sin envío de datos, seguro incluso para procesar retornos que contienen claves
  • Operaciones prácticas: carga/descarga de archivos, copia con un clic, retroceso en historial, compartir URL - todo incluido

Cómo Usar

  1. Pegar el contenido JSON o cargar un archivo JSON
  2. Elegir modo Embellecer, Comprimir o Validar, o cambiar a vista de árbol/mapa mental para visualización visual
  3. Visualizar la estructura jerárquica formateada y mensajes de error, cambiar si es necesario a conversión de código para generar estructura del lenguaje objetivo
  4. Copiar el contenido procesado, descargar el archivo o generar enlace compartible

Preguntas Frecuentes

¿Cómo formatear rápidamente un JSON de una sola línea en una estructura legible?

Simplemente pegue su contenido JSON para embellecerlo rápidamente. Ideal para visualizar respuestas de API, archivos de configuración y campos de registro. La herramienta agrega automáticamente indentaciones y saltos de línea, organizando los datos compactos en una estructura jerárquica clara. Por defecto se utilizan 2 espacios de indentación, también puede cambiar el tamaño de indentación en la barra de herramientas.

¿Cuál es la diferencia entre el formateo JSON y la reparación JSON?

El formateo JSON es más adecuado para procesar contenido que es válido pero difícil de leer, mientras que la reparación JSON es mejor para estructuras inválidas como errores, comillas faltantes y comas finales. Si se muestra un error durante el formateo, recomendamos primero realizar una reparación JSON. En resumen: el formateo solo ajusta el diseño sin modificar el contenido; la reparación intenta completar las comillas y paréntesis faltantes y eliminar comas superfluas para que vuelva a ser JSON válido.

¿Por qué se muestra un error durante el formateo JSON?

Generalmente se debe a que el contenido no es un JSON válido, por ej. por comentarios, comillas simples, comas finales o paréntesis no cerrados. La especificación JSON (RFC 8259) exige que las claves estén entre comillas dobles, las cadenas no pueden usar comillas simples, no debe haber coma después del último elemento y no se permiten comentarios // o /* */. En este caso, es mejor realizar primero una reparación JSON y luego formatear.

¿Es adecuado para depuración de API y visualización de respuestas de registros?

Absolutamente. Las respuestas de API, datos Webhook, registros de seguimiento y fragmentos de configuración a menudo deben formatearse antes de poder examinarse. La herramienta también admite la edición visual en la vista de árbol JSON, vista de mapa mental y conversión de código a 13 lenguajes de programación para ayudarle a comprender rápidamente las estructuras de datos.

¿Se puede convertir JSON a interfaces TypeScript o clases Java?

Sí. La herramienta admite la conversión de JSON a 13 formatos: TypeScript/Java/Python/Go/Rust/Swift/Kotlin/C#/C++/PHP/MySQL/YAML/XML. Genere la estructura de código correspondiente con un clic, ideal para crear rápidamente modelos de datos frontend y backend basados en respuestas de API.

¿Los datos JSON formateados se cargan en un servidor?

No. Todos los formateos, validaciones, compresiones y conversiones de código se ejecutan completamente localmente en su navegador, los datos no se cargan en servidores. Incluso al procesar respuestas de API que contienen claves, tokens o datos de usuario, es seguro. Después de cerrar la página, los datos se eliminan.

¿Puede procesar archivos JSON grandes?

Sí. La herramienta utiliza renderizado de desplazamiento virtual y análisis en segundo plano Web Worker, permitiendo formatear y navegar fluidamente JSON de varios MB sin bloquear la página. Para archivos muy grandes, recomendamos cargar directamente el archivo JSON en lugar de pegarlo para un rendimiento más estable.

¿Para qué sirve la compresión JSON (Minify)?

La compresión elimina todos los espacios y saltos de línea superfluos del JSON para obtener el resultado de una sola línea más compacto. Esto reduce significativamente el tamaño y ahorra ancho de banda y almacenamiento. Se usa frecuentemente para transmisión de API, escritura de configuraciones, integración en código o como variable de entorno. El JSON comprimido es semánticamente idéntico al anterior al formateo, solo menos legible por humanos.

¿Qué son la vista de árbol JSON y la vista de mapa mental?

La vista de árbol renderiza JSON como un árbol jerárquico reducible con expansión/reducción de nodos y edición visual de campos, ideal para explorar datos profundamente anidados. La vista de mapa mental presenta la estructura como conexiones de nodos y muestra intuitivamente las relaciones padre-hijo de objetos y matrices, ideal para estructurar estructuras de datos complejas o para presentaciones.

¿Se puede ordenar por claves después del formateo?

Sí. La herramienta ofrece una función de ordenación de claves que admite la reordenación de claves de objeto en orden alfabético ascendente o descendente. Práctico para comparar diferencias entre dos JSON, estandarizar el orden de campos en archivos de configuración o mostrar campos de API en un orden fijo para revisiones de código.

¿El resultado formateado se puede compartir con colegas?

Sí. La herramienta admite la compresión y codificación del contenido JSON actual en una URL para generar un enlace compartible. Al abrir el enlace, el destinatario ve los mismos datos sin que se cargue nada en un servidor. Ideal para la colaboración rápida durante la resolución de problemas de API o para reproducir escenarios de datos.

Acerca de JSON y el formateo JSON

JSON (JavaScript Object Notation) es un formato ligero de intercambio de datos que representa los datos mediante pares clave-valor y matrices. Debido a su simplicidad, legibilidad e independencia de lenguaje, se ha convertido en el estándar de facto para API Web, archivos de configuración, registros y transmisión de datos frontend-backend. JSON tiene solo seis tipos de valores básicos: cadena, número, booleano, null, objeto y matriz. Las reglas de sintaxis se definen conjuntamente por los estándares RFC 8259 y ECMA-404.

El formateo JSON (también llamado embellecimiento JSON, JSON Beautify) consiste en agregar indentaciones y saltos de línea apropiados al JSON compacto sin modificar el contenido de los datos, para llevarlo a una forma jerárquica legible por humanos. El JSON en respuestas de API, registros y almacenamiento a menudo está comprimido en una sola línea y es muy difícil de leer directamente. Después del formateo, puede ver claramente los anidamientos de objetos, elementos de matriz y valores de cada campo.

La operación opuesta al formateo es la compresión JSON (Minify), que elimina todos los espacios en blanco no necesarios y devuelve JSON a su forma de una sola línea más compacta para reducir el tamaño de transmisión. El formateo y la compresión son operaciones reversibles entre sí, ninguna modifica la semántica de JSON, solo afectan legibilidad y tamaño.

La validación JSON verifica si un texto cumple con las reglas de sintaxis JSON. Las escrituras inválidas comunes incluyen: uso de comillas simples en lugar de comillas dobles, claves sin comillas, coma final superflua después del último elemento, inserción de comentarios // o /* */, paréntesis o comillas no correctamente cerrados, etc. Estos no son JSON válidos, se señalará un error durante el formateo – en este caso, debe usar primero la herramienta de reparación JSON y luego formatear.

Esta herramienta ofrece además del formateo una vista de árbol, vista de mapa mental y conversión de código a 13 lenguajes de programación: puede reducir JSON a un árbol jerárquico visual para explorar estructuras profundas, o convertir con un clic el JSON de API en interfaces TypeScript, clases Java, diccionarios Python o instrucciones de creación de tablas de base de datos, para usar directamente en el desarrollo. Todos los procesamientos se realizan localmente en el navegador, los datos no se cargan en el servidor.

Tabla de referencia rápida de tipos de datos JSON

JSON tiene solo seis tipos de valores. Comprenderlos ayuda a juzgar rápidamente si los datos son válidos y cómo mapearlos a tipos de lenguajes de programación.

TipoEjemploDescripción
string"hello"Cadena, debe estar entre comillas dobles, admite caracteres de escape y codificación Unicode \uXXXX.
number25 / 3.14 / -1e5Número, admite enteros, decimales y notación científica, analizado en coma flotante de doble precisión, no distingue entre entero y flotante.
booleantrue / falseBooleano, solo puede ser true o false en minúsculas.
nullnullValor nulo, significa sin datos, debe estar en minúsculas, diferente de cadena vacía o 0.
object{"k": "v"}Objeto, colección de pares clave-valor rodeada por llaves, las claves deben ser cadenas entre comillas dobles.
array[1, 2, 3]Matriz, lista ordenada de valores rodeada por corchetes, los tipos de elementos pueden ser diferentes.

Tabla de caracteres de escape de cadenas JSON

Los siguientes caracteres en cadenas JSON deben escaparse con barra invertida, de lo contrario el análisis fallará.

EscapeSignificado
\"Comilla doble
\\Barra invertida
\/Barra diagonal (escape opcional)
\nSalto de línea
\rRetorno de carro
\tTabulador
\bRetroceso
\fAvance de página
\uXXXXCarácter Unicode en hexadecimal de cuatro dígitos

Tabla de comparación de escrituras inválidas comunes

A continuación se presentan escrituras JSON inválidas fáciles de confundir y sus formas válidas, para verificar en caso de error de formateo.

InválidoVálidoNota
{name: "a"}{"name": "a"}Las claves deben estar entre comillas dobles
{'name': 'a'}{"name": "a"}Las cadenas deben estar entre comillas dobles, no comillas simples
{"a": 1,}{"a": 1}No se permiten comas finales
{"a": 1} // comentario{"a": 1}JSON no admite comentarios
{"a": undefined}{"a": null}No existe undefined, use null para valores nulos
{"a": .5}{"a": 0.5}Los decimales deben tener un dígito entero 0

Code Examples

JavaScript: Formatear JSON con JSON.stringify

javascript

El tercer parámetro de JSON.stringify integrado en navegadores y Node.js especifica la indentación, es el método de programación más común para formatear JSON.

const data = { name: '张三', age: 25, tags: ['a', 'b'] };

// Embellecimiento: el tercer parámetro es el número de espacios de indentación (también puede pasar '\t' para Tab)
const pretty = JSON.stringify(data, null, 2);
console.log(pretty);

// Compresión: sin tercer parámetro, obtiene la una línea más compacta
const mini = JSON.stringify(data);
console.log(mini); // {"name":"张三","age":25,"tags":["a","b"]}

// Analizar cadena a objeto (verifica sintaxis, lanza SyntaxError en caso de inválidez)
const obj = JSON.parse(pretty);

Python: Formatear JSON con el módulo json

python

La biblioteca estándar de Python json controla la indentación y visualización de chino mediante los parámetros indent y ensure_ascii.

import json

data = {"name": "张三", "age": 25, "tags": ["a", "b"]}

# Salida embellecida, indent especifica indentación, ensure_ascii=False conserva el chino
pretty = json.dumps(data, indent=2, ensure_ascii=False)
print(pretty)

# Salida comprimida: usar los separadores más compactos
mini = json.dumps(data, separators=(",", ":"), ensure_ascii=False)
print(mini)

# Analizar cadena (lanza json.JSONDecodeError en caso de inválidez)
obj = json.loads(pretty)

Línea de comandos: Formatear JSON con jq

bash

jq es una herramienta potente para procesar JSON en línea de comandos, puede embellecer, comprimir y extraer campos rápidamente.

# Embellecimiento (indentación por defecto de 2 espacios)
cat data.json | jq '.'

# Comprimir a una sola línea
cat data.json | jq -c '.'

# Extraer un campo específico
cat data.json | jq '.user.name'

# Embellecer directamente el resultado de curl por tubería
curl -s https://api.example.com/user | jq '.'

Privacy & Security

Todos los formateos, validaciones, compresiones y conversiones de código JSON de esta herramienta se ejecutan completamente localmente en su navegador. Los datos no se cargan en servidores, ni se registran o almacenan en caché de forma remota. Incluso al procesar respuestas de API que contienen claves, tokens o información de usuario, es seguro. Después de cerrar o actualizar la página, los datos se eliminan.

Authoritative References

Troubleshooting

Unexpected token ... in JSON (Carácter inesperado / error de sintaxis)

Generalmente se debe a que se usan comillas simples, las claves no están entre comillas dobles o hay comentarios // , /* */ presentes. La especificación JSON exige que todas las cadenas y claves estén entre comillas dobles y no se admiten comentarios. Por favor cambie a comillas dobles y elimine comentarios, o use primero la herramienta de reparación JSON.

Unexpected end of JSON input (Fin de contenido inesperado)

Normalmente los paréntesis {} o [] o comillas no están correctamente cerrados, haciendo que JSON esté incompleto. Por favor verifique que las estructuras estén cerradas por pares. Al pegar respuestas de API, es posible que solo se haya copiado parte del contenido, asegúrese de copiar completamente.

La coma final provoca error (Trailing comma)

JSON no permite coma después del último elemento de un objeto o matriz, por ej. {"a":1,} o [1,2,] son inválidos. Elimine la coma superflua. Los objetos JavaScript permiten comas finales pero JSON no, tenga especial cuidado al copiar desde código.

Los caracteres chinos o especiales se muestran como \uXXXX

Esta es la escritura de escape Unicode de JSON, es en sí válida y se puede analizar normalmente después del formateo. Si desea mostrar directamente el chino, desactive el escape en el lado de producción (por ej. ensure_ascii=False en Python, desactivación de escape HTML en Go).

Pérdida de precisión de números grandes (ej. ID se convierte en notación científica o último dígito se pone a cero)

Los números JSON se analizan según IEEE 754 de coma flotante de doble precisión. Los enteros que superan 2^53 (ej. IDs Snowflake, números de pedido) pierden precisión. La solución es envolver los enteros grandes en cadenas durante la transmisión, es decir "id": "9007199254740993", para evitar que se analicen como números.

Volver a una línea después del formateo

Simplemente cambie a "Comprimir / Minify" para devolver el JSON multilínea embellecido a la una línea más compacta, para transmisión de API, escritura de configuraciones o integración en código. La compresión y el embellecimiento son operaciones inversas entre sí y no modifican el contenido de los datos.