JSON a CSV: la guía completa (2026)

JSON y CSV: dos formas para los mismos datos

JSON y CSV guardan datos tabulares, pero se diseñaron para lectores distintos. JSON es jerárquico y se describe a sí mismo: las claves nombran cada valor y las estructuras pueden anidarse a cualquier profundidad, que es justo lo que el código quiere cuando analiza la respuesta de una API. CSV es plano y mínimo: una fila de encabezado nombra las columnas y cada fila siguiente es un registro, que es justo lo que quiere una hoja de cálculo. Los dos formatos coinciden en el caso más simple y más común, una lista de registros que comparten los mismos campos, y en esa coincidencia es donde la conversión es limpia y sin pérdida. La fricción empieza cuando JSON usa un anidamiento que una cuadrícula plana no puede contener.

Cuándo convertir JSON a CSV

Conviertes JSON a CSV en el momento en que una persona necesita ver los datos en filas y columnas. Una API devuelve JSON, pero tu colega quiere ordenarlos y filtrarlos en Excel o Google Sheets. Un sistema de registro emite JSON, pero el equipo de finanzas necesita una hoja de cálculo. Una herramienta de importación, un CRM o un sistema de facturación acepta cargas en CSV pero no JSON en crudo. En todos los casos el trabajo es el mismo: tomar un arreglo de registros y aplanarlo en una fila de encabezado más una fila por registro. Bien hecho, el resultado se abre en cualquier hoja de cálculo en cualquier máquina sin software especial.

Cuándo convertir CSV a JSON

Lo inverso es igual de común. Un compañero sin perfil técnico envía una hoja de cálculo, exportada como CSV, y tu código necesita objetos estructurados para trabajar. Una API o un archivo de configuración espera un arreglo JSON, pero la fuente de verdad es una hoja que alguien mantiene a mano. Convertir CSV a JSON convierte cada fila en un objeto con claves tomadas del encabezado, que es la forma que JavaScript, Python y casi toda API hablan de forma nativa. Te ahorra escribir a mano un analizador frágil cada vez que un CSV llega a tu bandeja de entrada.

La estructura que se convierte limpia

La entrada ideal para pasar de JSON a CSV es un arreglo de objetos planos, donde cada objeto es un registro y cada clave es una columna. Un buen conversor recorre todos los objetos, arma el encabezado de columnas a partir de la unión de sus claves y deja una celda en blanco cuando a un registro le falta un campo. Eso significa que tus registros no tienen que ser perfectamente uniformes; una fila puede llevar un campo que a las otras les falta y la conversión sigue funcionando. Un solo objeto, en lugar de un arreglo, se vuelve una tabla de una fila. El problema empieza únicamente cuando los valores son a su vez objetos o arreglos, porque una celda de hoja de cálculo no tiene dónde poner un árbol.

Los delimitadores y el problema de la coma en Excel

CSV significa valores separados por comas, pero la coma no siempre es el separador. Excel instalado en muchas configuraciones regionales de Europa usa el punto y coma, porque en esas regiones la coma es el separador decimal. Esta es la razón más común de que un CSV «se vea roto» al abrirlo: cada fila cae en una sola columna porque Excel esperaba punto y coma y recibió comas. La solución es convertir con el delimitador que tu hoja de cálculo espera. En la duda, la salida separada por tabuladores es la opción más robusta, ya que los tabuladores rara vez aparecen dentro de los datos y se pegan limpios en una hoja sin ningún cuadro de importación.

Comillas, escapado y el viaje de ida y vuelta

CSV tiene exactamente una regla que hace tropezar a la gente. Si un valor contiene el delimitador, una comilla doble o un salto de línea, el campo entero debe ir entre comillas dobles, y cualquier comilla doble dentro debe escribirse dos veces. Así, el valor Smith, John se vuelve "Smith, John", y she said "hi" se vuelve "she said ""hi""". Un conversor correcto lo aplica de forma automática, y un analizador correcto lo revierte, así que un valor sobrevive sin cambios a un viaje de ida y vuelta de JSON a CSV a JSON. Una división ingenua por comas, en cambio, destroza cualquier campo que contenga una. Por eso un analizador de verdad le gana a un script de una línea en todo lo que no sean los datos más triviales.

Los datos anidados y sus límites

El límite honesto de cualquier conversión de JSON a CSV es el anidamiento. Una cuadrícula plana no tiene forma nativa de representar un objeto dentro de una celda ni un arreglo de hijos. Hay tres estrategias comunes, cada una con su concesión. La más simple, y lo que hace este conversor, es escribir el valor anidado como su texto JSON dentro de la celda, lo que mantiene los datos sin pérdida aunque no quede bonito. Un segundo enfoque aplana las claves anidadas en nombres de columna con puntos como address.city. Un tercero despliega los arreglos en varias filas. Cada uno cede algo, ya sea legibilidad, simplicidad o integridad de las filas, así que la opción correcta depende de lo que necesite la herramienta que recibe. Si tus datos están muy anidados, considera reformar el JSON a un arreglo plano primero.

Hacerlo en el navegador frente a la línea de comandos

Las herramientas de línea de comandos como jq y los scripts pequeños pueden convertir JSON y CSV, y son la opción correcta dentro de un proceso automatizado. Para una conversión puntual, en cambio, una herramienta del navegador es más rápida y segura: no hay nada que instalar, ninguna sintaxis que recordar y, lo crucial, los datos nunca salen de tu máquina, lo que importa cuando el archivo guarda registros de clientes o financieros. Un conversor del navegador que corre por completo del lado del cliente te da la comodidad de una herramienta en línea sin el costo de privacidad de subir datos sensibles al servidor de otra persona. Para validar el JSON antes de convertirlo, combina el conversor con un formateador de JSON.