IA en tu dispositivo: profesional y privado.

Documentos

Cómo convertir CSV a JSON (claves, tipos, delimitadores y codificación)

Convierte un archivo CSV a JSON en cuatro pasos. La primera fila pasa a ser las claves, los números siguen siendo números y los ceros iniciales se conservan.

Actualizado el 7 de noviembre de 20269 min de lectura

Para convertir un archivo CSV a JSON, suéltalo en el conversor de CSV a JSON, deja activada la opción «La primera fila es la cabecera» y pulsa Convertir. La primera fila se convierte en las claves y cada una de las demás filas en un objeto, de modo que obtienes un array como [{"id": 1, "name": "Ada"}]. Después copia el texto o descarga un archivo .json. Lo que decide si el resultado sirve no es la conversión en sí, sino cuatro detalles: cómo se detecta el delimitador, cómo se lee la codificación del archivo, qué ocurre con los números y las celdas vacías, y qué forma de salida eliges. Esta guía los repasa uno por uno.

Qué hace la conversión

Un archivo CSV es texto sin formato: una fila por línea, celdas separadas por un delimitador y, normalmente, una primera línea con el nombre de las columnas. JSON es texto estructurado con claves, valores y tipos. Convertir significa leer cada línea, dividirla en celdas, emparejar cada celda con el nombre de su columna y escribir los pares como JSON. Con la configuración por defecto, un archivo con la cabecera id,name,active y la fila 7,Ada,TRUE se convierte en un objeto con las claves id, name y active, donde 7 es un número y TRUE es un auténtico true.

Si solo quieres echar un vistazo al archivo antes, ábrelo en el visor de CSV. Y si no tienes claro que JSON sea el formato adecuado para tus datos, JSON frente a CSV y XML los compara.

Convertir un archivo CSV a JSON, paso a paso

1

Añade el archivo

Suelta un archivo .csv, .tsv, .txt o .psv en la página, o pulsa Buscar archivos. El delimitador, el carácter de comillas y la codificación se detectan y se muestran en «Lectura del archivo», así que puedes ver lo que se ha elegido.

2

Elige la forma de salida

Deja «Forma de salida» en Array de objetos si el resultado es para una API o una aplicación web. Las otras cuatro formas se explican más abajo.

3

Revisa la vista previa

La vista previa muestra los primeros 200 registros y se actualiza cada vez que cambias un ajuste. Fíjate en las claves, los números y las celdas vacías. Si las letras salen mal o las columnas aparecen unidas, corrige ahora la Codificación o el Delimitador.

4

Convierte y exporta

Pulsa Convertir a JSON y después usa Copiar JSON o Descargar JSON. Todo se ejecuta en tu dispositivo, no en nuestros servidores.

Todas las formas de salida y todas las opciones son gratuitas. Gratis: un archivo cada vez, de hasta 25 MB. Pro: lotes de hasta 50 archivos, descarga en un solo ZIP y combinación de archivos en un único documento.

Convertir CSV a JSON

La primera fila se convierte en las claves

Con «La primera fila es la cabecera» activada, la primera línea aporta los nombres de las propiedades. Con la opción desactivada, la primera línea se trata como datos y las columnas se llaman column_1, column_2 y así sucesivamente, de modo que no se pierde nada. Desactívala en archivos que empiezan directamente con datos, como muchas exportaciones de escáneres y registradores.

Las cabeceras reales son más desordenadas que las de los ejemplos, y la herramienta resuelve los problemas habituales en lugar de ocultarlos. Dos columnas llamadas id se pisarían entre sí, así que la segunda pasa a llamarse id_2. Una cabecera vacía recibe el nombre de su posición, por ejemplo column_4. Si un informe tiene un título y una línea en blanco encima de la cabecera real, usa «Omitir filas iniciales» para que la fila correcta sea la cabecera. El ajuste «Mayúsculas de las claves» permite dejar las claves como están escritas o pasarlas a minúsculas, MAYÚSCULAS, camelCase o snake_case; nada se renombra si no lo pides.

Muchas exportaciones escriben datos anidados como columnas planas llamadas address.city y address.zip. Activa «Anidar cabeceras con puntos» (punto o barra) y vuelven a agruparse en un objeto address. Viene desactivado por defecto, de modo que una columna que realmente se llama Revenue.2024 sigue plana.

¿Array de objetos u otra forma?

La forma decide qué hay en el nivel superior del archivo. Son archivos distintos, no presentaciones distintas de un mismo archivo.

Forma de salidaAspectoPara qué sirve
Array de objetos[{"id": 1, "name": "Ada"}]API, aplicaciones JavaScript y casi todo el código
Array de arrays[["id","name"],[1,"Ada"]]Datos en forma de matriz, o archivos con cabeceras duplicadas o ausentes
JSON LinesUn registro por línea, sin corchetesImportaciones a bases de datos y registros
Hash indexado{"SKU-1": {...}}Buscar registros por una columna de identificador
Arrays por columna{"id": [1,2], "name": [...]}Gráficos y bibliotecas de tablas de datos

Conviene saber dos detalles. JSON Lines nunca lleva sangría, porque un registro repartido en varias líneas rompería el formato. Y en un hash indexado, dos filas con el mismo valor de clave no pueden sobrevivir las dos: gana la última y la herramienta indica cuántas filas se han sustituido.

Números, booleanos, celdas vacías y ceros iniciales

Un archivo CSV no tiene tipos: todas las celdas son texto. El ajuste «Leer números, booleanos y null» viene activado y convierte las celdas en el valor JSON que parecen. El riesgo de detectar tipos es estropear datos, así que la herramienta deja algunos valores como texto a propósito.

Celda en el CSVEn el JSONMotivo
42 o 3,1442 o 3,14 (números)Números simples
1,234.56 o 1.234,561234.56Se entienden ambas convenciones de separadores; «Formato numérico» permite forzar una
(1,234.50)-1234.5Los paréntesis contables indican un valor negativo
TRUE, FALSE, true, falsetrue, false (booleanos)Lo que escriben las hojas de cálculo y el código
007 o 00123"007" o "00123" (texto)Los ceros iniciales no se pueden recuperar una vez eliminados
12345678901234567890Sigue siendo textoCon más de quince cifras significativas, como número se redondearía
+15551234567Sigue siendo textoUn teléfono, no una cantidad
2024-01-15"2024-01-15" (texto)JSON no tiene tipo fecha, así que se conserva el texto del archivo
50 $ o 12 %Sigue siendo textoEl símbolo tiene significado

Las celdas vacías pasan a ser null por defecto. «Celdas vacías» permite elegir una cadena vacía o dejar la clave fuera del registro. En las formas de arrays, omitir un valor desplazaría todas las columnas siguientes, así que ahí una celda vacía sigue siendo null. Si una columna es mixta, por ejemplo una columna casi numérica con algún «N/A» suelto, la lista de Columnas la marca como mixta y te deja forzarla a Texto, Número o Booleano.

Delimitadores, comillas y saltos de línea dentro de las celdas

La coma es solo el separador más habitual. Excel, en muchas configuraciones regionales europeas, escribe punto y coma, porque allí la coma es el separador decimal. También hay exportaciones con tabuladores (.tsv) y barras verticales (.psv). La detección automática compara coma, punto y coma, tabulador y barra comprobando cuál consigue que todas las filas tengan el mismo ancho, en lugar de contar caracteres, así que las comas dentro de una dirección entre comillas no la engañan. Si la vista previa muestra todo en una sola columna o una división extraña, elige el «Delimitador» a mano.

Una celda que contiene el delimitador o un salto de línea debe ir entre comillas dobles, y una comilla dentro de ella se duplica. El conversor sigue esas reglas, de modo que una celda como "Smith, John" sigue siendo un solo valor y una nota de varias líneas permanece en una sola celda. «Carácter de comillas» puede ponerse en simples o ninguna para el archivo ocasional que no sigue el estándar; una comilla solo abre un campo al principio del campo, lo que mantiene intacto un nombre como O'Brien.

Codificaciones que usa Excel

Si los acentos se convierten en caracteres raros, el archivo se ha leído con la codificación equivocada. Automático lee primero la marca de orden de bytes, después comprueba si el UTF-8 es válido y, por último, recurre a Windows-1252, que es lo que escribe Excel en un Windows occidental para un CSV normal. Una exportación «Texto Unicode» de Excel es UTF-16, que la herramienta lee bien si eliges UTF-16LE o si el propio archivo lo declara. También puedes forzar UTF-8, UTF-16BE o ISO-8859-1. Si un archivo declara su propia codificación, esa prevalece sobre el desplegable y la herramienta lo avisa. Más sobre cómo guarda Excel los archivos en abrir un CSV en Excel correctamente.

SíntomaCausa probableSolución
é aparece como éArchivo UTF-8 leído como Windows-1252Pon Codificación en UTF-8
Las comillas tipográficas y el signo del euro se ven como cuadrosArchivo Windows-1252 leído como UTF-8Pon Codificación en Windows-1252
Letras separadas o caracteres nulosArchivo UTF-16 leído como una codificación de un solo bytePon Codificación en UTF-16LE o Automático
Toda la fila en una celdaDelimitador incorrectoPon Delimitador en Punto y coma o Tabulador
Primera clave extrañaMarca de orden de bytes dentro de la claveSe resuelve automáticamente en UTF-8

Límites de tamaño y cómo comprobar el resultado

La conversión gratuita admite un archivo cada vez de hasta 25 MB, que es una exportación de hoja de cálculo muy grande, sin ninguna función restringida. Ten en cuenta que el JSON ocupa más que el CSV del que sale, porque cada fila repite todas las claves. Darle formato con 2 espacios, 4 espacios o un tabulador añade más, así que elige «Minificado» en Sangría cuando el tamaño importe. Pro añade la conversión de hasta 50 archivos, la descarga en un solo ZIP y la combinación de todos los archivos en un único array o en un único archivo JSON Lines.

Pega el resultado en el formateador de JSON si quieres inspeccionarlo o validarlo, y usa JSON a CSV para ir en sentido contrario; la guía de JSON a CSV explica esa dirección.

Preguntas frecuentes

¿Cómo convierto un archivo CSV a JSON?

Suelta el archivo en el conversor de CSV a JSON, deja activada «La primera fila es la cabecera», elige Array de objetos y pulsa Convertir a JSON. Después copia el resultado o descarga el archivo .json. La conversión gratuita admite un archivo de hasta 25 MB.

¿Cómo convierto un archivo de Excel a JSON?

En Excel, usa Guardar como y elige CSV (o Texto Unicode para un archivo UTF-16); después convierte ese CSV. Solo la hoja activa se guarda en un CSV, así que repite los pasos para cada hoja que necesites.

¿Por qué cambian mis números o mis ceros iniciales?

No cambian: valores como 007, los números de identificación largos, los teléfonos con signo más, las fechas y los importes con símbolos se quedan como texto a propósito. Los números simples pasan a ser números JSON. También puedes desactivar «Leer números, booleanos y null» para conservar todos los valores como texto.

¿Por qué se ven mal los acentos o los símbolos?

El archivo se ha decodificado con la codificación equivocada. Cambia Codificación a UTF-8 o Windows-1252 y observa la vista previa; los archivos de Excel guardados con una configuración occidental suelen ser Windows-1252.

¿Por qué sale todo en una sola columna?

El delimitador no es una coma. Elige Punto y coma, Tabulador o Barra en Delimitador. Excel, en muchas configuraciones regionales europeas, guarda con punto y coma.

¿Se sube mi CSV a algún sitio?

No. El archivo se lee y se convierte en tu dispositivo, no en nuestros servidores, y el resultado va directamente al portapapeles o a una descarga.

Sigue leyendo

Más sobre Documentos →