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
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.
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.
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.
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 JSONLa 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 salida | Aspecto | Para 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 Lines | Un registro por línea, sin corchetes | Importaciones 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 CSV | En el JSON | Motivo |
|---|---|---|
| 42 o 3,14 | 42 o 3,14 (números) | Números simples |
| 1,234.56 o 1.234,56 | 1234.56 | Se entienden ambas convenciones de separadores; «Formato numérico» permite forzar una |
| (1,234.50) | -1234.5 | Los paréntesis contables indican un valor negativo |
| TRUE, FALSE, true, false | true, 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 |
| 12345678901234567890 | Sigue siendo texto | Con más de quince cifras significativas, como número se redondearía |
| +15551234567 | Sigue siendo texto | Un 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 texto | El 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íntoma | Causa probable | Solución |
|---|---|---|
| é aparece como é | Archivo UTF-8 leído como Windows-1252 | Pon Codificación en UTF-8 |
| Las comillas tipográficas y el signo del euro se ven como cuadros | Archivo Windows-1252 leído como UTF-8 | Pon Codificación en Windows-1252 |
| Letras separadas o caracteres nulos | Archivo UTF-16 leído como una codificación de un solo byte | Pon Codificación en UTF-16LE o Automático |
| Toda la fila en una celda | Delimitador incorrecto | Pon Delimitador en Punto y coma o Tabulador |
| Primera clave extraña | Marca de orden de bytes dentro de la clave | Se 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.