Cómo convertir JSON a CSV

Qué puedes convertir

Esta herramienta convierte texto JSON en texto CSV para preparar datos destinados a hojas de cálculo, importaciones o revisiones rápidas. Admite un objeto como un registro y también una matriz no vacía que empiece por un objeto. El separador predeterminado es la coma, aunque puedes indicar otro carácter. La conversión no acepta texto vacío ni JSON con formato incorrecto.

Pasos para pasar JSON a CSV

1. Prepara el contenido JSON como texto. Usa un objeto en el nivel superior para convertir un registro, por ejemplo { "nombre": "Ana", "edad": 30 }. Para varios registros, utiliza una matriz no vacía cuyo primer elemento sea un objeto.

2. Pega el JSON en el campo de entrada de la herramienta. No dejes el campo vacío ni introduzcas solo espacios. Comprueba también que las comillas, llaves, corchetes y comas formen un JSON válido.

3. Si necesitas un separador distinto de la coma, indícalo en el control correspondiente. Cuando introduces varios caracteres, se utiliza solo el primero; si el valor está vacío, se mantiene la coma.

4. Inicia la conversión y revisa el CSV generado. La primera línea reúne los nombres de campo que aparecen en los registros, en el orden en que se encuentran por primera vez. Después aparece una fila por cada registro procesado. Si un registro no incluye un campo de la cabecera, su celda queda vacía. Los valores incluidos en las filas se escriben como texto.

Cómo leer el resultado y sus límites

La cabecera representa la unión de los nombres de campo encontrados durante el procesamiento y conserva el orden de primera aparición. Por eso, dos registros pueden producir columnas compartidas y dejar una celda vacía cuando uno de ellos carece de un campo. El resultado contiene una fila posterior a la cabecera por cada registro procesado.

Si utilizas una matriz, revisa también sus elementos posteriores. La validación inicial comprueba que la matriz no esté vacía y que empiece por un objeto, pero los elementos siguientes no se validan de forma independiente como objetos. Un valor escalar, null o una matriz en esa posición puede hacer que el procesamiento falle. Los valores que sí se incluyen en las filas se convierten a texto; no conviene interpretar esa conversión como una reorganización de estructuras anidadas en columnas independientes.

Ejemplo práctico

Una persona necesita convertir en CSV un registro de cliente antes de revisarlo en una hoja de cálculo.

Introduce como JSON { "nombre": "Ana", "edad": 30 }, conserva la coma como separador e inicia la conversión.

El resultado tiene una primera línea con nombre,edad y una fila posterior con Ana,30, porque el objeto contiene esos dos campos.

Limitaciones

• No se convierten entradas vacías, JSON incorrecto, matrices vacías ni valores JSON de nivel superior que no sean un objeto o una matriz válida. En una matriz que empiece por un objeto, un elemento posterior que no pueda tratarse como registro puede provocar un fallo.

Errores frecuentes

• Una matriz empieza por un objeto, pero contiene después un número, null o otra matriz. Comprueba que cada elemento destinado a convertirse en un registro sea un objeto antes de iniciar la conversión.

Preguntas frecuentes

¿Qué ocurre si no introduzco ningún JSON?

El campo vacío o formado solo por espacios se rechaza. Introduce texto JSON antes de iniciar la conversión.

¿Puedo convertir una matriz JSON?

Una matriz vacía se rechaza, y también una matriz cuyo primer elemento no sea un objeto. Una matriz que empiece por un objeto puede fallar si contiene después valores que no se puedan tratar como registros.

¿Puedo cambiar la coma por otro separador?

Sí. Si no indicas otro valor, se usa la coma. Cuando el separador proporcionado contiene varios caracteres, solo se utiliza el primero; un valor vacío vuelve a la coma.