Tutoriales paso a paso Datos y codificación

Cómo convertir JSON a CSV y viceversa

Convierte la respuesta de una API en un CSV listo para hoja de cálculo y un CSV de vuelta en JSON, con notas sobre cómo se tratan las columnas, los valores anidados y los tipos de datos.

Última revisión:

AdSense Placeholder
Slot: header_reference_page
En esta página

Pasos

  1. Comprueba que el JSON es válido

    Pégalo primero en el formateador JSON o en el validador JSON. Una coma o comilla ausente es la causa más común de que falle una conversión.

  2. Convierte JSON a CSV

    Pega un arreglo JSON de objetos en el conversor de JSON a CSV y convierte. La fila de encabezado es la unión de las claves de todos los objetos, en el orden en que aparecen por primera vez, y un campo ausente se convierte en una celda vacía.

  3. Inspecciona el CSV

    Por ejemplo, [{"id":1,"name":"Ana","tags":["a","b"]},{"id":2,"name":"Ben","city":"Lyon"}] se convierte en una tabla con las columnas id,name,tags,city. El arreglo de tags se guarda como el texto ["a","b"] y la celda tags de Ben queda vacía.

  4. Convierte el CSV de vuelta a JSON

    Pega el CSV en el conversor de CSV a JSON. La primera fila pasa a ser las claves y cada fila siguiente un objeto. Todos los valores son cadenas y una fila corta se completa con cadenas vacías.

  5. Valida la forma del resultado

    Si el JSON alimentará una API o una base de datos, describe cómo debe ser y compruébalo con el validador de esquemas JSON. Así detectas campos ausentes y valores que deberían ser números.

  6. Abre el CSV en una hoja de cálculo y revisa por muestreo

    Importa el archivo como texto UTF-8 y compara algunas filas con el origen. Vigila los identificadores con ceros a la izquierda y los números largos, que una hoja de cálculo puede reformatear al abrir el archivo.

Qué necesitas

JSON que sea un arreglo de objetos (un objeto por fila) o un CSV con fila de encabezado. Ambos conversores funcionan en local, así que puedes usar datos reales.

Qué hace la conversión

Convertir este JSON:

[{"id":1,"name":"Ana","tags":["a","b"]},{"id":2,"name":"Ben","city":"Lyon"}]

da este CSV:

id,name,tags,city
1,Ana,"[""a"",""b""]",
2,Ben,,Lyon

y convertir ese CSV de vuelta da:

[{"id": "1", "name": "Ana", "tags": "[\"a\",\"b\"]", "city": ""}, {"id": "2", "name": "Ben", "tags": "", "city": "Lyon"}]

Fíjate en lo que cambió en el viaje de ida y vuelta: id ahora es la cadena "1", el arreglo tags es ahora una cadena y los tags ausentes de Ben y la city ausente de Ana se volvieron cadenas vacías. El viaje de ida y vuelta conserva la tabla, no los tipos.

Reglas prácticas

Situación Qué ocurre
Los objetos tienen claves distintas Las columnas son la unión de todas las claves, en orden de primera aparición
Un valor es null o falta La celda queda vacía
Un valor es un objeto o arreglo anidado Se guarda en la celda como texto JSON compacto
Un campo contiene coma, comilla o salto de línea La celda se entrecomilla para que el CSV siga siendo válido
Fila CSV más corta que el encabezado Los valores ausentes se vuelven cadenas vacías

Errores comunes

  • Esperar que los tipos sobrevivan. CSV es texto. Convierte números y booleanos después de leerlo de nuevo.
  • Plano frente a anidado. Si necesitas estructura anidada real, mantén JSON como fuente de verdad y exporta CSV solo para informes.
  • Hojas de cálculo que alteran valores. Excel puede quitar ceros a la izquierda, convertir números largos en notación científica o reinterpretar texto que parece una fecha.
  • Usar TSV por error. Si tus datos contienen tabuladores o pegaste desde una hoja de cálculo, usa las variantes separadas por tabulador.

Para profundizar

Sobre cómo se estructura JSON, consulta Cómo funciona JSON; para una comparación con otros formatos, consulta JSON frente a YAML frente a XML.

Pruebe estas herramientas

Véase también

  • Guía Cómo funciona JSON
    Los seis tipos de valor JSON, por qué falla el análisis, trampas con enteros grandes y orden de claves, JSONPath y conversión a TypeScript.
  • Comparativa JSON frente a YAML frente a XML
    JSON para API e intercambio de datos, YAML para configuración editada a mano, XML para documentos y estándares con esquemas.
  • Glosario JSON
    JSON (JavaScript Object Notation) es un formato de texto ligero para datos estructurados, formado por objetos, matrices, cadenas, números.
  • Glosario CSV
    CSV (valores separados por comas) es un formato de texto plano para tablas, con una fila por línea y los valores separados por comas.

Preguntas frecuentes

CSV no tiene tipos de datos, así que convertir un CSV a JSON produce valores de texto: "1" en lugar de 1. Convierte los campos que necesites a números o booleanos en tu código, o compruébalos con un esquema.

Una celda CSV contiene un solo valor, así que un objeto o arreglo anidado se escribe en la celda como texto JSON compacto. Al convertir de vuelta obtienes ese texto como cadena, no la estructura original.

No. Ambos conversores funcionan en tu navegador, así que los datos nunca salen de tu dispositivo.

AdSense Placeholder
Slot: footer_leaderboard