Toolphy

Convertidor CSV a JSON

Pega un CSV con fila de encabezado y obtén un array JSON de objetos limpio — delimitador detectado automáticamente y comillas gestionadas correctamente.

0
Filas
0
Columnas

Cómo convertir CSV a JSON

Llevar datos tabulares a una aplicación suele implicar convertir una exportación de hoja de cálculo en JSON. Esta herramienta lee tu CSV en el navegador y construye un array JSON de objetos en unos segundos.

  1. Pega tu CSV. Copia el contenido de una hoja de cálculo o de un archivo .csv —incluida la fila de encabezado— y pégalo en el cuadro de entrada. Cada línea siguiente se convierte en un objeto JSON y cada encabezado pasa a ser una clave del objeto.

    Ejemplo: un archivo con el encabezado nombre,edad y las filas Ada,36 y Linus,54 produce [{"nombre":"Ada","edad":"36"},{"nombre":"Linus","edad":"54"}].

  2. Elige el delimitador. Déjalo en detección automática: la herramienta inspecciona la primera línea para decidir entre coma, punto y coma y tabulación. Fuérzalo manualmente cuando un archivo mezcle convenciones o el propio encabezado contenga delimitadores.

  3. Elige la forma de salida. El formateo añade sangría para que el JSON sea legible en un editor y en un diff; desactívalo para obtener la carga más compacta.

  4. Pulsa Convertir y luego copia o descarga. La herramienta muestra el número de filas y columnas y te permite copiar el JSON al portapapeles o guardar un archivo .json con un clic.

¿Qué es la conversión de CSV a JSON?

CSV (valores separados por comas) es un formato plano orientado a líneas donde cada fila es un registro y cada campo se separa con un delimitador. JSON (JavaScript Object Notation) es un formato jerárquico formado por objetos, arrays y valores tipados. Convertir CSV a JSON es más una elevación que un aplanado: las columnas nombradas en la fila de encabezado se convierten en las claves de cada objeto. La fila de encabezado es lo que da sentido al resultado. Sin ella, un analizador solo puede producir arrays de valores, difíciles de usar en el código de una aplicación. Esta herramienta trata siempre la primera fila como encabezado, de modo que una columna de hoja de cálculo llamada email se convierte en una propiedad email predecible en cada objeto. El CSV real es más sutil que un simple corte por comas. Los campos pueden ir entre comillas dobles para poder contener el delimitador, un salto de línea o una comilla; una comilla literal dentro de un campo entrecomillado se escribe dos veces, como "". El analizador sigue aquí la convención RFC 4180: un campo como "París, Francia" permanece en una sola celda en lugar de dividirse en dos. Todo el análisis se ejecuta localmente con JavaScript nativo. Tus datos nunca se suben a un servidor, algo importante cuando el CSV contiene información personal o comercialmente sensible.

Aplicaciones habituales

1. Alimentar una base de datos: convierte una hoja de cálculo de productos, usuarios o publicaciones en JSON que pueda insertarse directamente mediante una API o un script de importación.

2. Datos de prueba para el front-end: convierte una pequeña lista CSV en un conjunto de datos JSON para pruebas, historias de Storybook o un prototipo, sin escribir los objetos a mano.

3. Cargas útiles de API: remodela una tabla exportada de un back office con la forma de array de objetos que esperan la mayoría de los endpoints REST.

4. Pipelines de análisis: carga un CSV en un proyecto JavaScript o Node.js como registros estructurados en lugar de volver a analizar texto en cada ejecución.

5. Archivos de configuración: conserva una hoja de cálculo legible como fuente de verdad y regenera un archivo de configuración JSON cada vez que cambie.

Cómo se tratan los campos entrecomillados y los saltos de línea

La dificultad del CSV es que tanto la coma como el salto de línea son significativos y a la vez están permitidos dentro de un valor. La RFC 4180 lo resuelve con comillas dobles: cualquier campo que contenga el delimitador, una comilla doble o un salto de línea se encierra entre comillas, y una comilla interna se escapa duplicándola.

Tomemos un campo escrito como "Smith, John". Un corte ingenuo por la coma produciría dos columnas, pero esta herramienta reconoce la comilla de apertura, conserva la coma dentro del campo y devuelve la cadena única Smith, John. Un valor que contenga una comilla, como Dijo ""hola"", se decodifica a Dijo "hola", y un campo entrecomillado puede incluso abarcar varias líneas físicas, algo frecuente en direcciones o comentarios exportados.

Como el analizador sigue el estado de las comillas carácter a carácter, los saltos de línea internos nunca inician un nuevo registro. Si un campo entrecomillado queda abierto al final del archivo, la entrada es incorrecta y la herramienta lo avisa en lugar de devolver datos rotos. Los campos vacíos se convierten en cadenas vacías, así que una fila terminada en coma sigue produciendo la clave esperada con un valor vacío.

El resultado es una conversión fiel y sin pérdidas: el JSON conserva exactamente los caracteres que había en el CSV, sin los artefactos de comillas que dejaría un simple corte de texto.

Utilidades Relacionadas

Preguntas Frecuentes - FAQ

¿Mis datos se envían a un servidor?

No. Toda la conversión ocurre localmente en tu navegador con JavaScript nativo. Tu CSV nunca se sube, se registra ni se almacena en ningún sitio.

¿Cómo funciona la detección automática del delimitador?

La herramienta analiza la primera línea —ignorando los delimitadores que están dentro de campos entrecomillados— y cuenta las apariciones de coma, punto y coma y tabulación. Se elige el carácter más frecuente, y siempre puedes forzarlo manualmente.

¿El CSV necesita una fila de encabezado?

Sí. La primera fila se trata siempre como encabezado y sus valores se convierten en los nombres de propiedad de cada objeto JSON. Si falta o está vacía, la herramienta te pide una para que el resultado siga siendo útil.

¿Cómo se tratan los campos entrecomillados con comas o saltos de línea?

Los campos entre comillas dobles siguen la RFC 4180: los delimitadores y saltos de línea internos se conservan dentro del valor, y una comilla duplicada se decodifica a una sola comilla. Una comilla sin cerrar se detecta como entrada incorrecta.

¿Puedo obtener un JSON compacto o formateado?

Ambos. El formateo añade dos espacios de sangría para mejorar la legibilidad, mientras que desactivarlo produce la carga más compacta posible para API, almacenamiento o transferencia por red.

Última actualización: