Convertidor de CSV a JSON
Introducción
El Convertidor de CSV a JSON tiende un puente entre los datos en formato de hoja de cálculo y el JSON estructurado. Ya sea que esté importando datos de Excel a una aplicación web, preparando cargas útiles para API a partir de exportaciones de bases de datos o transformando archivos de configuración, esta herramienta maneja la conversión con precisión y flexibilidad.
A diferencia de las herramientas de línea de comandos que requieren instalación o de los servicios online que suben sus datos a un servidor, el Convertidor de CSV a JSON de Toollect opera completamente dentro de su navegador. Cada pulsación de tecla actualiza la salida JSON en tiempo real, brindándole retroalimentación inmediata. Sin transmisión de datos a través de la red, ofrece tanto velocidad como privacidad.
Con detección inteligente de delimitadores, inferencia de tipos, múltiples formatos de salida y una tabla de vista previa en vivo, este convertidor maneja los casos límite que hacen frustrante la conversión de CSV: campos entrecomillados que contienen comas, valores multilínea, recuentos de columnas inconsistentes y más.
Cómo funciona
El Convertidor procesa sus datos CSV a través de un pipeline de múltiples etapas diseñado para precisión y flexibilidad.
Análisis sintáctico
La herramienta lee su entrada CSV línea por línea usando un analizador personalizado que sigue las convenciones RFC 4180. Maneja adecuadamente:
- Campos entrecomillados: Los campos encerrados entre comillas dobles pueden contener delimitadores, saltos de línea y otros caracteres especiales
- Comillas escapadas: Las comillas dobles dentro de un campo se representan como dos comillas dobles consecutivas (
"") - Campos vacíos: Los delimitadores consecutivos producen valores de cadena vacía
- Espacios en blanco finales: Los espacios fuera de las comillas se recortan para una salida limpia
Detección de delimitadores
En modo de auto-detección, la herramienta analiza las primeras filas de sus datos, probando cada delimitador candidato (coma, tabulación, punto y coma) y seleccionando el que produce el recuento de columnas más consistente. Siempre puede anular manualmente el delimitador detectado.
Inferencia de tipos
Con la inferencia de tipos activada, la herramienta escanea cada valor y convierte los patrones reconocidos:
- Números: Enteros y decimales (
42,3.14,-1.5,1e10) se convierten en números JSON - Booleanos:
trueyfalse(sin distinción de mayúsculas/minúsculas) se convierten en booleanos JSON - Nulo:
null(sin distinción de mayúsculas/minúsculas) se convierte ennullJSON - Cadenas: Todo lo demás permanece como cadena
También puede activar el análisis de valores JSON, que intenta analizar campos que parecen objetos o arrays JSON.
Formateo de salida
La salida JSON final se genera según las opciones seleccionadas:
- Array de objetos: Cada fila se convierte en un objeto con los valores de la fila de encabezado como claves (predeterminado)
- Array 2D: Salida como un array de arrays, ignorando la fila de encabezado
- Clave por primera columna: Un objeto donde el valor de la primera columna de cada fila de datos se convierte en la clave
La salida se puede formatear (con sangría de 2 o 4 espacios) o minimizar a una sola línea.
Uso
Usar el Convertidor de CSV a JSON de Toollect no requiere configuración ni registro. Siga estos pasos:
-
Abra la herramienta — Navegue a la página del Convertidor de CSV a JSON. La interfaz muestra una zona de carga, un área de texto de entrada, un panel de configuración y un área de salida.
-
Ingrese sus datos — Pegue el texto CSV directamente en el área de texto, o haga clic en la zona de carga (o arrastre y suelte un archivo .csv) para cargar un archivo.
-
Revise la configuración — La herramienta detecta automáticamente el delimitador y activa los encabezados y la inferencia de tipos por defecto. Ajuste estas configuraciones según sus datos:
- Seleccione un delimitador diferente si la auto-detección es incorrecta
- Active o desactive "Primera fila como encabezados" si sus datos carecen de fila de encabezado
- Desactive la inferencia de tipos para mantener todos los valores como cadenas
-
Vista previa de los datos analizados — Haga clic en "Mostrar vista previa" para ver una tabla con sus datos CSV analizados. Esto ayuda a verificar que el delimitador y la configuración de encabezados sean correctos.
-
Verifique la salida JSON — La salida JSON se actualiza automáticamente mientras escribe. El área de texto de salida es de solo lectura para evitar ediciones accidentales.
-
Copie o descargue — Haga clic en "Copiar" para copiar el JSON al portapapeles, o en "Descargar JSON" para guardarlo como archivo .json.
Tutorial
Este tutorial explica cómo convertir un archivo CSV exportado de Excel en un array JSON para usar en una aplicación web.
Escenario: Tiene una hoja de cálculo de Excel con inventario de productos y desea importarla a una aplicación web que espera JSON.
- Exportar desde Excel — Guarde su hoja de cálculo como archivo CSV. Debería obtener algo como:
Product Name, SKU, Price, In Stock, Category
Widget Pro, WDG-001, 29.99, true, Tools
Gadget X, GDG-002, 49.95, false, Electronics
Super Tool, SUP-003, 99.00, true, Tools
Accessory Pack, ACC-004, 14.99, true, Accessories
-
Abra el Convertidor de CSV a JSON y arrastre el archivo CSV a la zona de carga. La herramienta carga el archivo, detecta el delimitador de coma y convierte los datos al instante.
-
Revise la vista previa — Haga clic en "Mostrar vista previa" para ver la representación tabular. Confirme que la fila de encabezado se analizó correctamente.
-
La salida JSON aparece como:
[
{
"Product Name": "Widget Pro",
"SKU": "WDG-001",
"Price": 29.99,
"In Stock": true,
"Category": "Tools"
},
{
"Product Name": "Gadget X",
"SKU": "GDG-002",
"Price": 49.95,
"In Stock": false,
"Category": "Electronics"
},
{
"Product Name": "Super Tool",
"SKU": "SUP-003",
"Price": 99,
"Category": "Tools"
},
{
"Product Name": "Accessory Pack",
"SKU": "ACC-004",
"Price": 14.99,
"In Stock": true,
"Category": "Accessories"
}
]
Observe que los valores de Price son números (no cadenas), los valores de In Stock son booleanos y el valor faltante de "In Stock" para "Super Tool" se omite.
- Pruebe las transformaciones de claves — Seleccione "snake_case" en el menú desplegable de formato de claves. La salida cambia a:
[
{
"product_name": "Widget Pro",
"sku": "WDG-001",
"price": 29.99,
"in_stock": true,
"category": "Tools"
}
]
- Pruebe el formato con clave — Seleccione "Clave por primera columna" para obtener un objeto indexado por nombre de producto:
{
"Widget Pro": {
"SKU": "WDG-001",
"Price": 29.99,
"In Stock": true,
"Category": "Tools"
},
"Gadget X": { ... }
}
- Descargue el resultado — Haga clic en "Descargar JSON" para guardar la salida como archivo .json listo para su aplicación web.
Consejos profesionales
Domine estas técnicas para aprovechar al máximo el Convertidor de CSV a JSON de Toollect:
-
Use la vista previa primero: Verifique siempre la tabla de vista previa antes de confiar en la salida JSON. Las columnas desalineadas, los delimitadores incorrectos o los problemas de codificación son inmediatamente visibles en la vista previa tabular
-
Maneje los ceros iniciales: Los códigos postales, números de teléfono e IDs suelen tener ceros iniciales. Desactive la inferencia de tipos para mantenerlos como cadenas; de lo contrario,
00123se convierte en el número123 -
Normalice los nombres de columnas: Use la configuración de formato de claves para transformar encabezados inconsistentes en un formato uniforme. Para integraciones con API, camelCase o snake_case son generalmente preferidos
-
Limpie su CSV primero: Elimine filas vacías al final, verifique recuentos de columnas consistentes y asegúrese de que los campos entrecomillados usen comillas dobles para obtener mejores resultados
-
Combine con otras herramientas: Convierta CSV a JSON aquí, luego use el Formateador JSON para validar e inspeccionar la estructura
Alternativas
Si bien el Convertidor de CSV a JSON de Toollect ofrece un conjunto completo de funciones, existen varias alternativas para diferentes casos de uso.
| Herramienta / Método | Mejor para | Limitaciones |
|---|---|---|
| Convertidor de CSV a JSON de Toollect | Conversión basada en navegador, privacidad, personalizable | Requiere carga inicial de página |
| PapaParse (biblioteca JavaScript) | Análisis programático de CSV en Node.js o navegador | Requiere codificación, sin interfaz gráfica |
| csvkit (línea de comandos) | Procesamiento y conversión de CSV con Python | Requiere instalación de Python, solo línea de comandos |
| Servicios de conversión online | Conversiones rápidas y puntuales | Los datos se suben a servidores, problemas de privacidad |
| Excel Power Query | Conversión de CSV a JSON dentro de Excel | Requiere Excel, limitado a conjuntos de datos pequeños |
| jq (línea de comandos) | Procesamiento de salida JSON de conversiones CSV | Requiere paso separado CSV a JSON, solo línea de comandos |
Para la mayoría de los usuarios que necesitan una conversión rápida, privada y rica en funciones de CSV a JSON sin salir del navegador, el convertidor de Toollect ofrece el mejor equilibrio entre funcionalidad y conveniencia.
Solución de problemas
| Problema | Causa probable | Solución |
|---|---|---|
| JSON muestra "[null]" u objetos vacíos | La detección de delimitador falló o se seleccionó el delimitador incorrecto | Seleccione manualmente el delimitador correcto en el menú desplegable |
| Faltan valores de columna / están desplazados | Un campo contiene el carácter delimitador sin comillas | Encierre los campos con delimitadores entre comillas dobles en su CSV original |
| Los números con ceros iniciales pierden los ceros | La inferencia de tipos los convierte en valores numéricos | Desactive la inferencia de tipos para mantener todos los valores como cadenas |
| Error "Fila X tiene Y columnas, se esperaban Z" | Recuento de columnas inconsistente entre filas | Revise su CSV para detectar delimitadores adicionales/faltantes; los campos entrecomillados con saltos de línea pueden abarcar varias líneas |
| La vista previa muestra caracteres distorsionados | La codificación del archivo no es UTF-8 | Re-exporte su CSV como UTF-8 desde su aplicación de hoja de cálculo |
| La carga de archivos grandes falla | El archivo supera el límite de 10 MB | Pegue los datos directamente en el área de texto en lugar de subirlos |
| La salida JSON está vacía | El campo de entrada está vacío o contiene solo espacios en blanco | Asegúrese de que sus datos CSV estén pegados correctamente |
| El botón Copiar no responde | Permisos del portapapeles del navegador | Verifique la configuración del navegador; use Ctrl+C (Cmd+C) como alternativa |
Especificaciones técnicas
Benchmarks de rendimiento
| Tamaño de datos | Tiempo de procesamiento | Uso de memoria |
|---|---|---|
| 1 KB (10 filas) | < 1 ms | < 1 MB |
| 100 KB (1000 filas) | < 10 ms | < 5 MB |
| 1 MB (10000 filas) | < 100 ms | < 50 MB |
Detalles técnicos
- Analizador: Analizador CSV personalizado compatible con RFC 4180 con manejo completo de comillas y escape
- Inferencia de tipos: Detección basada en expresiones regulares para números, booleanos y valores nulos
- Detección de delimitadores: Puntuación heurística sobre las primeras 10 filas, probando coma/tabulación/punto y coma
- Motor de salida:
JSON.stringify()nativo con sangría configurable - Manejo de archivos: API
FileReadercon límite de tamaño de 10 MB - Portapapeles:
navigator.clipboard.writeText()con indicador de retroalimentación de 2 segundos - Descarga:
Blob+URL.createObjectURL()para generación de archivos en memoria
Compatibilidad con navegadores
| Navegador | Versión mínima | Estado |
|---|---|---|
| Google Chrome | 80+ | Soporte completo |
| Mozilla Firefox | 75+ | Soporte completo |
| Apple Safari | 13+ | Soporte completo |
| Microsoft Edge | 80+ | Soporte completo |
| Samsung Internet | 13+ | Soporte completo |
| Opera | 67+ | Soporte completo |
Privacidad y seguridad
- Transmisión de datos cero: todo el procesamiento de CSV ocurre en la memoria del navegador
- Las cargas de archivos se leen localmente a través de la API FileReader y nunca se transmiten
- No se utilizan cookies, localStorage ni sessionStorage
- No hay scripts de análisis o seguimiento en la página de la herramienta
- No se requiere registro, inicio de sesión ni claves de API
Características
- Conversión instantánea de CSV a JSON con vista previa en vivo
- Detección inteligente automática de delimitadores con anulación manual
- Inferencia de tipos para números, booleanos y valores nulos
- Múltiples formatos de salida: array de objetos, array 2D y objetos con clave
- Transformación de mayúsculas/minúsculas en claves (camelCase, snake_case, lowercase, UPPERCASE, Capitalize)
- Vista previa de datos plegable para verificar el CSV antes de convertir