De filas y columnas a objetos JSON
El CSV es como las hojas de cálculo y las bases de datos exportan tablas, mientras que el JSON es lo que esperan las aplicaciones web, las API y el código JavaScript. Pasar de uno a otro a mano es tedioso y propenso a errores, sobre todo cuando los valores contienen comas, comillas o saltos de línea.
Este conversor analiza el CSV con PapaParse, un analizador de CSV probado, convierte la primera fila en nombres de propiedades y escribe cada fila siguiente como un objeto. Detecta el delimitador automáticamente, así que los archivos separados por punto y coma de las versiones europeas de Excel funcionan igual que los separados por comas.
CSV frente a JSON: comparación rápida
| Característica | CSV | JSON |
|---|---|---|
| Nombre completo | Comma-Separated Values (valores separados por comas) | JavaScript Object Notation |
| Tipo | Datos tabulares | Datos jerárquicos |
| Año de creación | Principios de los 70; descrito en la RFC 4180 de 2005 | Principios de los 2000 (RFC 4627 en 2006) |
| Creado por | Sin un propietario único | Douglas Crockford; hoy ECMA-404 y RFC 8259 |
| Estructura | Filas y columnas planas | Objetos y arrays anidados |
| Comentarios | No | No |
| Tipos de datos | Solo texto, sin tipos integrados | Cadena, número, booleano, null, objeto, array |
| Ideal para | Exportar hojas de cálculo e importar a bases de datos | APIs, aplicaciones web y ajustes de apps |
| Compatibilidad | Excel, Google Sheets, bases de datos y todos los lenguajes | Todos los lenguajes de programación |
| Tipo MIME | text/csv | application/json |
Cómo convertir CSV a JSON
Paso 1: Exporta o guarda un CSV
Usa Archivo, Guardar como, CSV en tu hoja de cálculo, o toma la exportación de tu base de datos o aplicación.
Paso 2: Suelta el archivo .csv
Comprueba que la primera fila contenga los nombres de las columnas.
Paso 3: Convierte
Las filas se analizan con soporte completo para campos entrecomillados y se convierten en objetos.
Paso 4: Descarga el JSON
Obtienes un archivo .json con sangría y un array de objetos.
Detalles del análisis
Detección del delimitador
Comas, punto y coma, tabulaciones y barras verticales se reconocen automáticamente.
Campos entrecomillados
Los valores con comas, comillas o saltos de línea entre comillas se leen correctamente.
Cabeceras limpias
Se eliminan los espacios alrededor de los nombres de columna y la marca de orden de bytes inicial.
Filas vacías ignoradas
Las filas en blanco al final de las exportaciones no generan objetos vacíos.
Dónde resulta útil CSV a JSON
Cargar datos en una app web. Convierte una hoja de productos o usuarios en datos de prueba.
Datos para sitios estáticos. Alimenta Astro, Next.js o Eleventy con archivos JSON.
Pruebas de API. Construye cuerpos de petición a partir de filas de una hoja.
Gráficos y mapas. Muchas bibliotecas de visualización prefieren JSON.
Por qué todos los valores son cadenas
El CSV no tiene tipos de datos, así que el conversor mantiene cada valor exactamente como está escrito, como cadena JSON. Eso protege los valores que solo parecen números: códigos postales como 02134, teléfonos, códigos de producto e identificadores muy largos se estropearían con una conversión numérica automática.
Si necesitas números o booleanos reales, convierte esos campos en tu código, donde sabes qué columnas son numéricas. Las celdas vacías se convierten en cadenas vacías.
- "02134" sigue siendo "02134", no 2134.
- "TRUE" sigue siendo una cadena hasta que tú decidas lo contrario.
- "1,234.50" se conserva intacto para que lo proceses tú.
Requisitos de la fila de cabecera
La primera línea siempre se trata como cabecera. Si tu archivo no la tiene, añádela antes de convertir; si no, la primera fila de datos se convertirá en los nombres de las propiedades.
Los nombres de columna duplicados se vuelven únicos con un sufijo numérico, para que no se sobrescriba ningún valor. Las celdas de cabecera vacías generan propiedades sin nombre, que quizá quieras completar antes.
Consejos para CSV a JSON
- Usa cabeceras cortas y aptas para código, como nombre en lugar de Nombre del cliente (opcional).
- Elimina las filas de totales y las notas al final de los informes exportados.
- Guarda el CSV en UTF-8 para mantener intactos los caracteres con tilde.
- ¿Necesitas un diccionario clave/valor en vez de un array? Transforma el JSON en tu código después de convertir.
Preguntas sobre la conversión de CSV a JSON
¿Cómo es el JSON resultante?
Un array de objetos, uno por fila, con nombres de propiedades tomados de la cabecera y sangría de dos espacios.
¿Los números se convierten en números?
No. Los valores se mantienen como cadenas para proteger los ceros iniciales y los identificadores largos.
¿Admite archivos separados por punto y coma?
Sí. El delimitador se detecta automáticamente, incluidos punto y coma, tabulaciones y barras verticales.
¿Los valores pueden contener comas y saltos de línea?
Sí, siempre que estén entre comillas dobles, que es como los exportan las hojas de cálculo.
¿Y los archivos de Excel?
Usa antes el conversor de XLSX a CSV, o guarda la hoja como CSV desde Excel.
¿Se sube mi CSV?
No. La conversión se ejecuta en tu navegador.