Salida CSV
El JSON de ejemplo produce este CSV:
name,age,email
Alice,30,alice@example.com
Bob,25,bob@example.comCada objeto en el arreglo se convierte en una fila. Las claves name, age y email se convierten en encabezados de columna en el orden en que aparecen en el primer objeto.
Cómo se Asignan los Arreglos JSON a CSV
CSV es fundamentalmente un formato tabular. Requiere un conjunto uniforme de columnas en todas las filas, lo que significa que tu entrada JSON debe ser un arreglo de objetos con una estructura consistente.
| JSON | CSV |
|---|---|
| Arreglo de objetos | Filas con encabezado |
| Claves de objeto | Encabezados de columna |
| Valores de objeto | Valores de celda |
| Clave faltante | Celda vacía |
| Objeto anidado | Nombre de columna aplanado |
| Valor de arreglo | String unido en celda |
El convertidor escanea todos los objetos en el arreglo, recopila la unión de sus claves y usa ese conjunto como encabezados de columna. Cada objeto se convierte en una fila con valores colocados bajo la clave correspondiente.
Cuándo Convertir JSON a CSV
Análisis de Tablas
Excel, Google Sheets y Numbers leen CSV nativamente. Si tus datos viven en una API JSON o exportación de base de datos, convertirlos a CSV te permite abrirlos en una hoja de cálculo para ordenar, filtrar, tablas pivote y gráficos sin escribir código.
Importación de Datos
La mayoría de herramientas de importación de datos aceptan CSV: cargadores masivos de bases de datos, pipelines ETL, sistemas CRM y plataformas de analíticas. Convertir JSON a CSV te permite mover datos desde una API web a estos sistemas a través de un formato estándar.
Correo Electrónico y Reportes
Muchas herramientas de negocio generan reportes como CSV para adjuntos de correo electrónico. Si estás construyendo un sistema que produce JSON, convertir a CSV produce un archivo universalmente legible que los stakeholders no técnicos pueden abrir en cualquier aplicación de hoja de cálculo.
Intercambio de Datos
CSV es el lenguaje común del intercambio de datos entre organizaciones. Cuando necesitas compartir datos estructurados con un socio que usa un stack tecnológico diferente, CSV evita la negociación de formatos porque cada lenguaje y herramienta puede leerlo.
Manejo de Casos Extremos
Comas en Valores
CSV usa comas como delimitadores, por lo que los valores que contienen comas deben envolverse en comillas. El convertidor maneja esto automáticamente: un valor como "Istanbul, Turkey" se convierte en "Istanbul, Turkey" en la celda CSV.
Nuevas Líneas en Valores
Los strings JSON multin línea rompen los límites de filas CSV a menos que el valor esté entre comillas. El convertidor envuelve los valores con nuevas líneas en comillas dobles, que es el escape CSV estándar para este caso.
Unicode y Caracteres Especiales
Los archivos CSV necesitan codificación adecuada. UTF-8 es el valor por defecto seguro. El convertidor produce CSV codificado en UTF-8, que Excel y la mayoría de herramientas modernas manejan correctamente. Las versiones antiguas de Excel en Windows pueden necesitar que el archivo se guarde con BOM (marca de orden de bytes) para mostrar caracteres no ASCII correctamente.
Limitaciones de JSON a CSV
CSV no puede representar datos jerárquicos. Si tu JSON tiene estructuras profundamente anidadas, pierdes la información de anidamiento al convertir a CSV. Los nombres de columnas aplanadas preservan la ruta, pero el consumidor debe parsearlos de vuelta. Para datos verdaderamente jerárquicos, mantente con JSON o convierte a un formato que soporte anidamiento como XML o YAML.
Las relaciones uno a muchos (como un usuario con múltiples direcciones) son particularmente incómodas en CSV. O duplicas la fila del usuario para cada dirección o unes las direcciones en una sola celda, ambas hacen más difícil el procesamiento posterior.