Conversor de JSON a CSV

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

La conversión de JSON a CSV transforma datos estructurados de formato JSON a valores separados por comas, un formato tabular que hojas de cálculo, bases de datos y herramientas de análisis consumen de forma nativa. JSON almacena datos como objetos y arrays anidados sin un esquema fijo. CSV almacena datos como filas y columnas con una fila de cabecera que define los nombres de campo. La conversión es el puente que lleva los datos de API a hojas de cálculo y bases de datos.

CSV (Comma-Separated Values) está definido por RFC 4180. Cada línea es un registro, y los campos dentro de una línea están separados por un carácter delimitador, habitualmente una coma. Los campos que contienen el delimitador, comillas dobles o saltos de línea deben ir entre comillas dobles, con las comillas internas escapadas duplicándolas. Este escapado es la principal fuente de errores al escribir un conversor de JSON a CSV a mano.

La conversión es sencilla cuando la entrada es un array plano de objetos con claves consistentes. Cada objeto se convierte en una fila, y cada clave única se convierte en una cabecera de columna. Los objetos y arrays anidados requieren un paso de aplanamiento, y las claves inconsistentes entre objetos requieren una estrategia para manejar los campos ausentes — habitualmente dejando la celda vacía. Un conversor fiable gestiona automáticamente todos estos casos extremos.

¿Por qué convertir JSON a CSV?

Las APIs devuelven JSON, pero las hojas de cálculo, las bases de datos SQL y las herramientas BI esperan datos tabulares. Convertir JSON a CSV permite mover datos entre estos sistemas sin escribir scripts de importación personalizados.

Casos de uso de JSON a CSV

Referencia de delimitadores CSV

El carácter delimitador separa los campos dentro de cada fila. La coma es el más habitual, pero otros delimitadores son estándar en contextos específicos. Elegir el delimitador incorrecto provoca que los campos se fusionen o se dividan incorrectamente al abrir el archivo.

Manejo de JSON anidado en CSV

CSV es un formato plano sin manera nativa de representar objetos o arrays anidados. Cuando tu JSON contiene estructuras anidadas, el conversor debe aplanarlas en columnas. Hay varias estrategias, y la elección correcta depende de cómo se vaya a consumir el CSV.

Ejemplos de código

Convertir JSON a CSV de forma programática requiere gestionar la extracción de cabeceras, el entrecomillado de campos y el escapado de delimitadores. La mayoría de los lenguajes tienen soporte nativo o de librería estándar para escribir CSV.

const data = [
  { name: "Alice", age: 30, city: "Berlin" },
  { name: "Bob", age: 25, city: "Tokyo" },
]

// Extract headers from the first object
const headers = Object.keys(data[0])
const csv = [
  headers.join(","),
  ...data.map(row => headers.map(h => {
    const val = String(row[h] ?? "")
    // Quote fields that contain commas, quotes, or newlines
    return val.includes(",") || val.includes('"') || val.includes("\n")
      ? '"' + val.replace(/"/g, '""') + '"'
      : val
  }).join(","))
].join("\n")

console.log(csv)
// → name,age,city
// → Alice,30,Berlin
// → Bob,25,Tokyo

import json, csv, io

json_str = '[{"name":"Alice","age":30,"city":"Berlin"},{"name":"Bob","age":25,"city":"Tokyo"}]'
data = json.loads(json_str)

output = io.StringIO()
writer = csv.DictWriter(output, fieldnames=data[0].keys())
writer.writeheader()
writer.writerows(data)

print(output.getvalue())
# → name,age,city
# → Alice,30,Berlin
# → Bob,25,Tokyo

# Using jq to convert JSON array to CSV
echo '[{"name":"Alice","age":30},{"name":"Bob","age":25}]' | \
  jq -r '(.[0] | keys_unsorted) as $k | $k, (.[] | [.[$k[]]] ) | @csv'
# → "name","age"
# → "Alice",30
# → "Bob",25

# Using Miller (mlr) for streaming conversion
echo '[{"name":"Alice","age":30}]' | mlr --json --ocsv cat
# → name,age
# → Alice,30

package main

import (
    "encoding/csv"
    "encoding/json"
    "fmt"
    "os"
)

func main() {
    jsonStr := `[{"name":"Alice","age":30},{"name":"Bob","age":25}]`
    var data []map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    w := csv.NewWriter(os.Stdout)
    // Write header
    headers := []string{"name", "age"}
    w.Write(headers)
    // Write rows
    for _, row := range data {
        record := make([]string, len(headers))
        for i, h := range headers {
            record[i] = fmt.Sprintf("%v", row[h])
        }
        w.Write(record)
    }
    w.Flush()
    // → name,age
    // → Alice,30
    // → Bob,25
}

Preguntas frecuentes