Convertidor de CSV a JSON

CSV y JSON: dos formas de transportar los mismos datos

La mayoría de los datos tabulares acaban viviendo en uno de dos formatos. CSV es la lengua materna de la hoja de cálculo: un archivo de texto plano donde cada línea es una fila y las comas separan las columnas. JSON es el lenguaje de las APIs y las aplicaciones: un formato de texto estructurado construido a partir de objetos (pares de clave y valor) y arrays (listas ordenadas). Describen la misma información con formas muy distintas, que es justo la razón por la que convertir entre ellos surge tan a menudo. Esta página hace esa conversión en ambas direcciones, por completo dentro de tu navegador.

CSV brilla allí donde una cuadrícula resulta natural. Exporta un informe de una base de datos, descarga una lista de pedidos o guarda una hoja de Excel o Google Sheets, y casi siempre obtienes CSV. Es compacto, legible para los humanos y cualquier herramienta de análisis del planeta puede abrirlo. JSON brilla allí donde el software habla con el software. Las APIs REST lo envían y lo reciben, los archivos de configuración lo usan y JavaScript lo lee sin ninguna biblioteca de análisis. Cuando necesitas introducir una exportación de hoja de cálculo en una API o volcar la respuesta de una API en una hoja de cálculo, en realidad estás traduciendo entre estos dos mundos.

Cómo las filas y los encabezados se convierten en objetos

La correspondencia es más sencilla de lo que parece. La primera línea de un archivo CSV suele ser la fila de encabezados, y esos nombres de encabezado se convierten en las claves de JSON. Cada fila siguiente se convierte en un objeto, donde cada celda se empareja con el encabezado correspondiente. El archivo entero se convierte en un array de esos objetos. Así, un CSV con las columnas name,email,age se transforma en una lista como [{"name": "Ada", "email": "ada@example.com", "age": "36"}, ...]. En el otro sentido, de JSON a CSV se leen las claves del primer objeto para construir la línea de encabezados, y luego se escribe una fila por objeto. Es un viaje de ida y vuelta limpio y predecible siempre que tus datos sean genuinamente tabulares.

Los detalles a tener en cuenta

CSV parece trivial pero esconde algunos filos. El mayor son las comas dentro de un campo. Si una dirección contiene "Berlín, Alemania", una división ingenua por comas partiría ese único valor en dos columnas. El estándar CSV resuelve esto envolviendo esos campos en comillas dobles, y las comillas dentro de un campo entrecomillado se duplican (""). Un buen conversor respeta esas reglas para que tus datos no se desplacen de columna en silencio. Vigila también el delimitador: muchas exportaciones europeas usan un punto y coma en lugar de una coma, porque allí la coma ya es separador decimal. También aparecen tabuladores y barras verticales.

La diferencia más profunda son los tipos. CSV no tiene ningún concepto de tipos de datos. Todo es texto, así que el número 42, el booleano true y una celda vacía parecen simples cadenas de texto. JSON, en cambio, distingue números, cadenas, booleanos, null y estructuras anidadas. Cuando conviertes CSV a JSON, los valores llegan como cadenas salvo que se le indique a la herramienta que interprete números y booleanos. Convertir JSON a CSV tiene el problema opuesto: los objetos y arrays anidados no encajan limpiamente en una cuadrícula plana, así que normalmente se aplanan o se convierten a texto dentro de una sola celda. Saber esto de antemano te ahorra desconcertarte luego por qué una columna "se ve mal".

Un viaje de ida y vuelta real

Aquí va un escenario que surge constantemente. Un colega te envía una hoja de cálculo de nuevos usuarios y te pide que los cargues a través de una API interna. La API solo acepta JSON. Exportas la hoja a CSV, la pegas aquí y recuperas un array limpio de objetos listo para insertar en la carga útil de tu petición. Más tarde, la API devuelve una lista JSON de los registros que creó, y necesitas devolvérsela al mismo colega para que la revise. Pegas el JSON, lo conviertes a CSV y se abre directamente en su hoja de cálculo. Sin scripts, sin instalaciones, solo dos traducciones rápidas en medio de un flujo de trabajo normal.

Solo local, por diseño

Todo esto se ejecuta en tu navegador. Tu CSV y tu JSON se analizan y se convierten con JavaScript en tu propia máquina, y nada se sube a un servidor. Eso importa porque las exportaciones suelen contener nombres reales, correos, detalles de pedidos o identificadores internos que no deberías pegar en un servicio remoto cualquiera. Aquí los datos nunca salen de la página. Si quieres ordenar el resultado después, nuestro formateador de JSON lo embellecerá y validará, y puedes explorar el resto de nuestros conversores de datos para formatos relacionados.

Preguntas frecuentes