Cómo formatear y validar JSON (y corregir los errores más comunes)

JSON está en todas partes: respuestas de API, archivos de configuración, ajustes de aplicaciones, datos exportados. Los ordenadores lo leen sin problema, las personas no tanto, sobre todo cuando llega comprimido en una sola línea. Y JSON es estricto: falta una coma o sobra una comilla, y el programa que lo lee se rinde.

Esta guía explica cómo formatear JSON para que sea legible, cómo validarlo y cómo corregir los seis errores que hay detrás de la mayoría de JSON rotos, con el formateador y validador de JSON gratuito.

Formatear y validar: ¿qué diferencia hay?

Formatear (también llamado embellecer) solo cambia la presentación: añade saltos de línea y sangría para que la estructura se siga fácilmente. Las claves, los valores y su orden quedan exactamente igual. Compara:

{"user":{"id":1024,"name":"Ada Lovelace","roles":["admin","editor"],"active":true}}

{
  "user": {
    "id": 1024,
    "name": "Ada Lovelace",
    "roles": ["admin", "editor"],
    "active": true
  }
}

Validar comprueba que el texto cumple las reglas de JSON, para que cualquier programa pueda leerlo. Un buen validador no se limita a decir “no válido”: te dice dónde está el problema y qué falla.

Cómo formatear y validar JSON, paso a paso

1. Abre el formateador de JSON.
2. Añade tu JSON. Pégalo en Entrada JSON, haz clic en Abrir archivo o suelta un archivo .json en el recuadro. Haz clic en Ejemplo para probar con uno de muestra.
3. Mira la comprobación en vivo. Mientras escribes, el recuadro muestra ✓ Es un JSON válido o un error con su línea y columna. Ir al error te lleva directamente al punto.
4. Elige la presentación. En Sangría, elige 2 espacios, 4 espacios o Tabulador. Marca Ordenar claves de la A a la Z si quieres las propiedades en orden alfabético.
5. Haz clic en Formatear y validar. El JSON formateado aparece a la derecha, con un breve resumen de su estructura. Usa Copiar o Descargar para llevártelo.

Los 6 errores de JSON más comunes y cómo corregirlos

1. Una coma después del último elemento

Muchos lenguajes de programación la admiten, JSON no. Quita la coma antes de un } o ] de cierre.

// mal
{ "name": "Ada", "age": 36, }

// bien
{ "name": "Ada", "age": 36 }

2. Comillas simples

Los textos y los nombres de propiedad deben ir entre comillas dobles. Las simples son una costumbre de JavaScript, no de JSON.

// mal
{ 'name': 'Ada' }

// bien
{ "name": "Ada" }

3. Nombres de propiedad sin comillas

En JavaScript puedes escribir name: "Ada"; en JSON cada nombre de propiedad necesita comillas dobles.

// mal
{ name: "Ada" }

// bien
{ "name": "Ada" }

4. Comentarios

JSON no admite comentarios. Elimínalos o guarda las notas en un campo aparte, como "_note". (Algunas herramientas aceptan variantes como JSONC o JSON5, pero los lectores de JSON estándar no.)

// mal
{
  "port": 8080 // the web server
}

// bien
{
  "port": 8080
}

5. Una coma que falta entre elementos

Cada propiedad y cada elemento de un array deben ir separados por una coma. Suele pasar al pegar dos partes juntas.

// mal
{ "name": "Ada" "age": 36 }

// bien
{ "name": "Ada", "age": 36 }

6. Valores que JSON no conoce

JSON solo tiene textos, números, true, false, null, objetos y arrays. NaN, undefined y True con mayúscula no están permitidos.

// mal
{ "score": NaN, "ok": True, "x": undefined }

// bien
{ "score": null, "ok": true, "x": null }

El validador reconoce cada uno de estos errores y lo explica con palabras sencillas, con la línea y la columna donde ocurre.

Dos cosas que muchos formateadores hacen mal

• Números grandes. Muchos formateadores online pasan el JSON por JavaScript, que redondea sin avisar los ID grandes: 9007199254740993 se convierte en 9007199254740992, y 1.10 en 1.1. Nuestro formateador conserva cada número exactamente como lo escribiste.
• Claves duplicadas. Si la misma propiedad aparece dos veces en un objeto, la mayoría de programas se quedan sin avisar solo con el último valor. El formateador te avisa para que decidas cuál es el correcto.

Más cosas que puedes hacer con JSON

• Minificar JSON: elimina todos los espacios innecesarios para que ocupe lo mínimo antes de enviarlo.
• JSON a CSV: abre tus datos en Excel o Google Sheets.
• JSON a YAML y JSON a XML: para archivos de configuración y sistemas que esperan esos formatos.
• ¿Comparas dos versiones? Formatea las dos primero y usa luego el comparador de archivos, como se explica en cómo comparar dos archivos online.

¿Se sube mi JSON?

No. El formateo y la validación ocurren en tu navegador, así que tus datos nunca salen de tu dispositivo. Importa, porque un JSON a menudo contiene claves de API, datos de clientes o ajustes internos.

Preguntas frecuentes

¿Uso 2 o 4 espacios?

Los dos valen; es cuestión de gustos. 2 espacios es lo más habitual en JSON y hace más estrechos los datos muy anidados.

¿Ordenar las claves cambia mis datos?

No. El orden de las propiedades de un objeto no tiene significado en JSON, así que el JSON ordenado contiene exactamente los mismos datos. Solo hace más fácil revisar y comparar objetos largos.

¿Puede un JSON tener comentarios?

No. El JSON estándar no los admite. Quita los comentarios antes de usar el archivo o guarda las notas en un campo normal.