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

CSV (Comma-Separated Values) es un formato plano y tabular. JSON (JavaScript Object Notation) es un formato jerárquico utilizado en APIs web, bases de datos y programación.

Convertir de CSV a JSON es útil cuando:

• Importa datos a una REST API

• Da formato a datos para la interacción frontend/backend

• Trabaja con objetos dinámicos en JavaScript o Python

Cómo convertir CSV a JSON (y viceversa) usando Python

Python facilita el cambio entre formatos CSV y JSON, útil para manipulación de datos, preparación de payloads de API o simplemente para ordenar hojas de cálculo. Aquí tiene una guía rápida usando bibliotecas integradas y algunas opciones populares de terceros.

Conversión de CSV a JSON

Puede convertir un archivo CSV a JSON usando los módulos integrados csv y json:

import csv
import json
csvfile = open('input.csv', 'r')
jsonfile = open('output.json', 'w')
reader = csv.DictReader(csvfile)
data = list(reader)
json.dump(data, jsonfile, indent=2)
csvfile.close()
jsonfile.close()

• csv.DictReader lee cada fila del CSV como un diccionario (con los encabezados de columna como claves).

• json.dump escribe la lista de diccionarios en un archivo JSON.

Conversión de JSON a CSV

import json
import csv
jsonfile = open('input.json', 'r')
csvfile = open('output.csv', 'w', newline='')
data = json.load(jsonfile)
writer = csv.DictWriter(csvfile, fieldnames=data[0].keys())
writer.writeheader()
writer.writerows(data)
jsonfile.close()
csvfile.close()

Para archivos más grandes o más funciones

Bibliotecas como pandas simplifican las conversiones cuando se trabaja con grandes conjuntos de datos:

import pandas as pd
CSV to JSON
df = pd.read_csv('input.csv')
df.to_json('output.json', orient='records', indent=2)
JSON to CSV
df = pd.read_json('input.json')
df.to_csv('output.csv', index=False)

Bibliotecas populares de terceros para conversión de CSV y JSON

En Python:

• pandas: Ideal para conjuntos de datos grandes y transformaciones complejas.

• json2csv: Herramienta práctica para conversiones frecuentes entre JSON y CSV.

• csvkit: Suite de herramientas de línea de comandos para manipular archivos CSV.

Para JavaScript y Node.js:

• papaparse: Análisis y conversión de CSV del lado del cliente, ideal para aplicaciones React.

• json2csv: Simplifica la conversión de objetos JSON a archivos CSV en entornos Node.

• csv-parse / csv-stringify: Utilidades robustas de análisis y serialización del conjunto csv.

En proyectos React:

• react-json-to-csv: Exporta datos JSON desde la interfaz de usuario con un solo clic.

• react-papaparse: Integra el análisis de CSV del lado del cliente directamente en componentes React.

¿Qué son el modo tersivo y el modo JSON Lines?

• Modo tersivo: Genera salida compacta, eliminando espacios innecesarios. Útil para archivos minimizados.

• Modo JSON Lines (también conocido como NDJSON): Muestra cada objeto JSON en su propia línea. Ideal para transmisión de grandes conjuntos de datos o integración con sistemas como Apache Kafka o Elasticsearch.

¿Qué es el JSON con clave y cómo generarlo desde un archivo CSV?

El JSON con clave transforma un CSV en un objeto JSON donde los valores de una columna específica se convierten en claves únicas. Cuando el valor de la columna clave es único para cada fila, obtendrá un mapeo limpio:

{
"alice@example.com": { "name": "Alice", "age": 30 },
"bob@example.com": { "name": "Bob", "age": 25 }
}

Si hay duplicados en la columna clave, cada clave apuntará a un array de objetos:

{
"NY": [
{ "name": "Alice", "age": 30, "city": "NY" },
{ "name": "Carol", "age": 35, "city": "NY" }
],
"LA": [
{ "name": "Bob", "age": 25, "city": "LA" }
]
}

Opciones de conversión disponibles

• CSV a JSON: Genera un array de objetos JSON. Soporta JSON anidado y modo JSON Lines.

• CSV a JSON con clave: Usa un campo específico como clave.

• CSV a array JSON: Salida en array de arrays o estructura con nombres de columnas y arrays de datos.

• CSV a array JSON por columnas: Cada columna se convierte en su propio array de valores.

• Generar JSON mediante plantilla: Use plantillas para personalizar la estructura de salida JSON.

• TSV a JSON: También se admiten valores separados por tabulaciones.

• Detección inteligente de tipos: Reconoce automáticamente números, booleanos y nulos cuando es posible.

Ejemplo 1: Entrada CSV básica

Entrada CSV:

name,age,city
Alice,30,New York
Bob,25,LA

Salida JSON:

[
{
"name": "Alice",
"age": "30",
"city": "New York"
},
{
"name": "Bob",
"age": "25",
"city": "LA"
}
]

Ejemplo 2: CSV con campos entre comillas

Entrada CSV:

name,comment
"Alice","Loves ""quotes"""
"Bob","Said: Hello, world!"

Salida JSON:

[
{
"name": "Alice",
"comment": "Loves "quotes""
},
{
"name": "Bob",
"comment": "Said: Hello, world!"
}
]

Ejemplo 3: CSV con valores faltantes

Entrada CSV:

name,age,email
Alice,30,alice@example.com
Bob,,bob@example.com

Salida JSON:

[
{
"name": "Alice",
"age": "30",
"email": "alice@example.com"
},
{
"name": "Bob",
"age": "",
"email": "bob@example.com"
}
]

Consejos Profesionales

• Asegúrese de que los encabezados sean únicos y descriptivos.

• Los valores faltantes se interpretarán como cadenas vacías en JSON.

• Use CSV a YAML si prefiere un formato más legible para personas.

• Los valores JSON se devuelven como cadenas; conviértalos en código según sea necesario.

• Para datos complejos con arrays anidados, use herramientas de scripting o preprocese su CSV. Puede usar barras (/) en los encabezados de columna para indicar anidamiento, por ejemplo address/street, address/city.

Casos de Uso

• Desarrollo de API: Prepare datos semilla para REST APIs.

• Intercambio de datos: Convierta exportaciones de hojas de cálculo en payloads JSON utilizables.

• Constructores de formularios: Rellene desplegables y formularios desde archivos CSV.

• Plataformas sin código: Habilite flujos de automatización usando salida JSON.

• Frameworks frontend: Alimente datos tabulares a herramientas como React o Vue mediante props o estado.

¿Necesita invertir el proceso?

Pruebe nuestro Convertidor de JSON a CSV o explore otras herramientas como XML a JSON, YAML a JSON y CSV a XML para mayor flexibilidad.

Aprenda Más

• ¿Qué es JSON?, comprenda los fundamentos de la estructura, sintaxis y casos de uso de JSON

• Comentarios en JSON, aprenda a gestionar comentarios y anotaciones en archivos JSON

• Comprensión del esquema JSON, guía para definir y validar estructuras de datos JSON