BrowserTools
Inicio / Conversores / Conversor de JSON a CSV, aplana matrices JSON en hojas de cálculo

Conversor de JSON a CSV, aplana matrices JSON en hojas de cálculo

Convierte una matriz JSON de objetos a CSV en tu navegador. Aplana objetos y matrices anidados, detecta columnas, previsualiza y descarga el archivo.

Cargando Conversor de JSON a CSV, aplana matrices JSON en hojas de cálculo… Si no ocurre nada, activa JavaScript.

Pega una matriz JSON de objetos, o suelta un archivo .json en cualquier parte de la herramienta, y obtén al instante un archivo CSV listo para usar. El conversor detecta automáticamente las columnas tomando la unión de todas las claves encontradas en todos los objetos, de modo que los registros con campos distintos o ausentes se alinean correctamente: los valores ausentes se convierten simplemente en celdas vacías. La tabla de vista previa muestra las primeras 20 filas exactamente como aparecerán en tu hoja de cálculo, y un contador de filas y columnas confirma de un vistazo el tamaño del resultado.

Preguntas frecuentes

¿Qué estructura JSON acepta el conversor?
Una matriz de objetos de nivel superior, por ejemplo [{"name": "Alice", "age": 30}, {"name": "Bob"}]. Cada elemento se convierte en una fila del CSV. Si el valor de nivel superior es un objeto, una cadena o un número, o si algún elemento de la matriz no es un objeto, la herramienta muestra un error claro que explica exactamente qué encontró en su lugar.
¿Cómo se gestionan los objetos anidados?
Se aplanan usando notación de puntos. Un objeto como {"address": {"city": "Lisbon", "zip": "1000"}} produce dos columnas, address.city y address.zip. El aplanado funciona a cualquier profundidad, así que las respuestas de API profundamente anidadas se convierten sin preprocesamiento manual.
¿Cómo se gestionan las matrices dentro de los objetos?
Cada elemento recibe su propia columna con un índice entre corchetes: {"tags": ["admin", "dev"]} se convierte en las columnas tags[0] y tags[1]. Las matrices de objetos combinan ambas reglas, de modo que items[0].price y items[1].price aparecen como columnas separadas. Las filas con matrices más cortas dejan vacías las columnas sobrantes.
¿Qué ocurre cuando los objetos tienen claves distintas?
El conjunto de columnas es la unión de todas las claves encontradas en todos los objetos, en orden de primera aparición. Un objeto al que le falta una clave simplemente recibe una celda vacía en esa columna, así que los datos heterogéneos (habituales en exportaciones NoSQL y registros de API) se convierten limpiamente sin perder ningún campo.
¿Cuándo debo elegir el delimitador de punto y coma?
Cuando el archivo esté destinado a Excel en una configuración regional europea (España, Portugal, Francia, Alemania y otras), donde la coma es el separador decimal y Excel espera CSV separado por punto y coma. Para la mayoría de las demás herramientas, incluidas Google Sheets y las bibliotecas de programación, la coma estándar es la opción segura. El tabulador es útil para pegar directamente en una hoja de cálculo.
¿Qué hace la opción de entrecomillar todo?
Por defecto, los campos solo se envuelven en comillas dobles cuando contienen el delimitador, una comilla o un salto de línea, que es el estilo mínimo del RFC 4180. Entrecomillar todo envuelve cada campo en comillas, algo que exigen algunos importadores estrictos, sistemas heredados y canalizaciones de datos. Ambos modos escapan las comillas internas duplicándolas.
¿Cómo se escapan los caracteres especiales como comillas y saltos de línea?
Siguiendo la convención RFC 4180: cualquier campo que contenga el delimitador, una comilla doble o un salto de línea se encierra entre comillas dobles, y cada comilla doble dentro del campo se duplica. Es el escapado que entienden Excel, Google Sheets, el módulo csv de Python y prácticamente todos los analizadores de CSV.
¿Se sube mi JSON a un servidor?
No. El análisis, el aplanado y la generación del CSV ocurren íntegramente en tu navegador con JavaScript. Nada de lo que pegas o sueltas sale de tu máquina, así que la herramienta es segura para exportaciones confidenciales como listas de clientes, registros financieros o respuestas de API con tokens.
¿Por qué los caracteres acentuados se ven mal al abrir el CSV en Excel?
Excel asume una codificación heredada a menos que el archivo empiece con una marca de orden de bytes UTF-8. El botón de descargar CSV añade esa marca automáticamente, así que los acentos, las diéresis y otros caracteres no ASCII se muestran correctamente. Si usas el botón de copiar y pegas en otro sitio, la aplicación de destino controla la codificación.
¿Hay algún límite de tamaño de archivo?
El único límite es la memoria de tu navegador. Archivos de decenas de megabytes con cientos de miles de filas se convierten sin problema en una máquina típica; la vista previa solo muestra las primeras 20 filas, así que la interfaz sigue siendo fluida incluso con entradas grandes.

Acerca de Conversor de JSON a CSV, aplana matrices JSON en hojas de cálculo

El JSON del mundo real rara vez es plano, así que el conversor aplana la estructura automáticamente. Los objetos anidados se expanden con notación de puntos: {"address": {"city": "Lisbon"}} se convierte en una columna llamada address.city. Las matrices se expanden con índices entre corchetes: {"tags": ["admin", "dev"]} se convierte en tags[0] y tags[1]. Las dos reglas se combinan a cualquier profundidad, de modo que una respuesta de API profundamente anidada como orders[0].items[2].price se transforma en un nombre de columna limpio y predecible sin trabajo manual.

Las opciones de salida cubren las particularidades de cada aplicación de hojas de cálculo. Elige coma, punto y coma o tabulador como delimitador; el punto y coma es lo que Excel espera en la mayoría de las configuraciones regionales europeas, donde la coma es el separador decimal. Desactiva la fila de encabezado cuando añadas datos a una hoja existente, y activa el entrecomillado total cuando un importador estricto exija que cada campo vaya entre comillas dobles. El escapado sigue la convención RFC 4180: los campos que contienen el delimitador, comillas o saltos de línea se envuelven en comillas dobles, y las comillas internas se duplican. El archivo descargado incluye una marca de orden de bytes UTF-8 para que Excel muestre correctamente los caracteres acentuados.

Todo se ejecuta en el lado del cliente, en tu navegador: el JSON que pegas o sueltas nunca se sube, se registra ni se almacena, lo que hace que la herramienta sea segura para exportaciones con datos de clientes, credenciales o registros internos. Los mensajes de error son precisos en lugar de crípticos: se te indica si el JSON no se pudo analizar (con el mensaje del propio analizador), si el valor de nivel superior no es una matriz o qué elemento concreto no es un objeto. Los usos típicos incluyen convertir respuestas de API REST en hojas de cálculo, preparar datos para Excel o Google Sheets y alimentar exportaciones JSON a herramientas que solo aceptan CSV.

De las tarjetas perforadas a las API REST: la extraña pareja de los formatos de datos

El CSV es mucho más antiguo de lo que la mayoría supone. Las listas de valores separados por comas aparecen en la primerísima versión del compilador FORTRAN de IBM en 1972, y la idea general de campos separados por delimitadores se remonta a la tabulación con tarjetas perforadas. Sin embargo, durante sus primeras tres décadas el CSV no tuvo especificación alguna: cada programa inventaba sus propias reglas para las comillas, los finales de línea y las comas incrustadas, y por eso analizar los archivos CSV ajenos se convirtió en un rito de iniciación para los programadores. El formato solo se puso por escrito en 2005, cuando el RFC 4180 documentó las convenciones de facto: campos separados por comas, comillas duplicadas para escapar y registros terminados en CRLF. Aun así, el RFC se describe a sí mismo como una mera documentación de la práctica existente, no como la definición de un estándar.

El JSON es la mitad mucho más joven de la pareja, y fue descubierto más que inventado. Douglas Crockford lo nombró y especificó en 2001, pero, como le gusta señalar, la sintaxis de literales de objeto de JavaScript ya existía: él simplemente extrajo un subconjunto independiente del lenguaje, publicó la página de una sola hoja json.org y escribió una especificación lo bastante corta como para imprimirse en una tarjeta de visita. El ascenso del JSON siguió al de las API web: desplazó al XML en los años 2000 sobre todo porque era más ligero de transmitir y se correspondía directamente con las estructuras de datos de todos los lenguajes principales, convirtiéndose en estándar ECMA en 2013 y en RFC (8259) en 2017.

Los dos formatos perduran porque se sitúan en extremos opuestos de un compromiso. El JSON expresa jerarquía, anidamiento, tipos y matrices, lo que lo hace ideal para que las máquinas hablen con máquinas. El CSV expresa una cuadrícula plana, lo que lo hace ideal para los humanos que miran datos en una hoja de cálculo, todavía la herramienta analítica más usada del mundo. Casi todas las canalizaciones de datos necesitan cruzar esa frontera en algún momento, aplanando estructuras anidadas en filas y columnas, que es precisamente la transformación de notación de puntos e índices entre corchetes que realiza este conversor. Medio siglo después de las comas de FORTRAN y un cuarto de siglo después de json.org, traducir entre los dos sigue siendo una de las tareas más comunes del trabajo con datos.

Apoyar