qktools

Introducción a JSON: Sintaxis, estructura y errores comunes

Publicado el 2026-06-06

JSON es el formato de intercambio de datos más popular en la actualidad, utilizado en casi todas las interfaces web y archivos de configuración. Es conciso, fácil de leer y compatible con múltiples lenguajes. Este tutorial te guiará desde lo básico para entender las reglas de sintaxis de JSON y los errores frecuentes, ayudándote a comprenderlo y escribirlo correctamente rápidamente.

¿Qué es JSON?

JSON, cuyas siglas significan JavaScript Object Notation, es un formato de datos de texto ligero. Describe datos estructurados de manera legible para humanos y es compatible de forma nativa con la mayoría de los lenguajes de programación, convirtiéndose en el lenguaje común para el intercambio de datos entre frontend, backend y servicios.

Tipos de datos básicos

JSON admite seis tipos de valores: cadenas de texto (encerradas entre comillas dobles), números, valores booleanos (true / false), null, objetos (llaves) y arrays (corchetes).

Ten en cuenta: las cadenas de texto deben ir entre comillas dobles, no comillas simples; los números no llevan comillas; estos son los puntos que más suelen confundir a los principiantes.

Objetos y arrays

Un objeto es una colección de pares "clave-valor", encerrado entre llaves, donde la clave debe ser una cadena de texto con comillas dobles, por ejemplo {"name": "小明", "age": 18}. Un array es una "lista ordenada de valores", encerrada entre corchetes, por ejemplo [1, 2, 3].

Los objetos y arrays pueden anidarse de forma arbitraria para expresar estructuras jerárquicas complejas, como un objeto de usuario que contiene un objeto de dirección y un array de etiquetas.

Errores de formato más comunes

Los errores más frecuentes entre principiantes incluyen: una coma adicional después del último elemento (coma final), uso de comillas simples, claves sin comillas, llaves o comillas no correspondientes, y escribir comentarios dentro de JSON (el JSON estándar no admite comentarios).

Estos errores causarán fallos en el análisis. Si encuentras un error, primero ubica el número de línea según el mensaje, y luego verifica cuidadosamente los puntos mencionados.

Validar y formatear con herramientas

En el desarrollo real, formatear un JSON desordenado con sangría facilita mucho su lectura y depuración. Puedes usar la herramienta de formateo de JSON de qktools para formatear, comprimir y validar JSON en un clic, con mensajes de error precisos sobre la causa.

Si necesitas convertir JSON a una tabla, también puedes usar la herramienta JSON a CSV para ver y procesar los datos en hojas de cálculo de forma conveniente.

Herramientas relacionadas