JSON to CSV

Vad är JSON till CSV-konvertering?

JSON till CSV-konvertering omvandlar strukturerad data från JSON-format till kommaseparerade värden, ett tabellformat som kalkylblad, databaser och analysverktyg hanterar direkt. JSON lagrar data som nästlade objekt och matriser utan ett fast schema. CSV lagrar data som rader och kolumner med en rubrikrad som definierar fältnamn. Konverteringen är hur API-data når kalkylblad och databaser.

CSV (Comma-Separated Values) definieras av RFC 4180. Varje rad är en post, och fält inom en rad separeras av ett avgränsningstecken, vanligast ett komma. Fält som innehåller avgränsningstecknet, dubbla citattecken eller radbrytningar måste omges av dubbla citattecken, med interna citattecken escapade genom att fördubbla dem. Denna escapning är den vanligaste källan till buggar när man skriver en JSON-till-CSV-omvandlare för hand.

Konverteringen är enkel när inmatningen är en platt matris av objekt med konsekventa nycklar. Varje objekt blir en rad, och varje unik nyckel blir en kolumnrubrik. Nästlade objekt och matriser kräver ett tillplatningssteg, och inkonsekventa nycklar mellan objekt kräver en strategi för att hantera saknade fält — vanligtvis genom att lämna cellen tom. En pålitlig omvandlare hanterar alla dessa kantfall automatiskt.

Varför konvertera JSON till CSV?

API:er returnerar JSON, men kalkylblad, SQL-databaser och BI-verktyg förväntar sig tabelldata. Att konvertera JSON till CSV låter dig flytta data mellan dessa system utan att skriva anpassade importskript.

Användningsfall för JSON till CSV

Referens för CSV-avgränsare

Avgränsningstecknet separerar fält inom varje rad. Komma är vanligast, men andra avgränsare är standard i specifika sammanhang. Att välja fel avgränsare gör att fält slås samman eller delas upp felaktigt när filen öppnas.

Hantering av nästlad JSON i CSV

CSV är ett platt format utan ett inbyggt sätt att representera nästlade objekt eller matriser. När din JSON innehåller nästlade strukturer måste omvandlaren tillplatta dem till kolumner. Det finns flera strategier, och rätt val beror på hur CSV:n ska konsumeras.

Kodexempel

Att konvertera JSON till CSV programmatiskt kräver hantering av rubrikextraktion, fältcitering och avgränsarescapning. De flesta språk har inbyggt eller standardbiblioteksstöd för CSV-skrivning.

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
}

Vanliga frågor