CSV'den JSON'a Dönüştürücü

CSV'den JSON'a Dönüşüm Nedir?

CSV (Virgülle Ayrılmış Değerler), her satırın bir veri kaydını ve kayıt içindeki alanların genellikle virgül olan bir ayırıcıyla birbirinden ayrıldığı düz metin tablo biçimidir. CSV, RFC 4180 ile resmileştirilmiş ve kişisel bilgisayarların ilk günlerinden bu yana standart bir veri alışverişi biçimi olmuştur. Elektronik tablolar, veritabanları ve veri dışa aktarım araçlarının tümü CSV üretir; çünkü CSV basit, kompakt ve neredeyse tüm programlama dilleri tarafından okunabilir.

JSON (JavaScript Object Notation), yapılandırılmış verileri anahtar-değer çiftleri ve sıralı diziler olarak temsil eder. CSV'nin aksine JSON, iç içe nesneleri, türlendirilmiş değerleri (sayılar, boolean, null) ve değişken uzunluklu kayıtları destekler. JSON, JavaScript motorları tarafından yerel olarak anlaşıldığından tarayıcı-sunucu veri alışverişi ile REST API yanıtları için baskın biçim hâline gelmiştir. Bu özellikler JSON'ı web API'leri, yapılandırma dosyaları ve MongoDB ile CouchDB gibi NoSQL veritabanları için varsayılan biçim yapar.

CSV'den JSON'a dönüştürmek, tablonun her satırını bir JSON nesnesine eşlemek, başlık satırını özellik adları ve hücre değerlerini özellik değerleri olarak kullanmak anlamına gelir. Sonuç genellikle bir JSON nesne dizisidir. Bu dönüşüm, düz tablo verilerini bir REST API, bir frontend veri tablosu bileşeni veya belge odaklı bir veritabanı gibi yapılandırılmış JSON girişi bekleyen bir sisteme beslemek istediğinizde gereklidir.

Bu Aracı Neden Kullanmalısınız?

Bu dönüştürücü, CSV'nizi tarayıcıda ayrıştırır, JSON çıktısını anında oluşturur ve verilerinizi asla sunucuya göndermez.

CSV'den JSON'a Kullanım Senaryoları

CSV Ayırıcı Başvurusu

CSV dosyaları her zaman virgül kullanmaz. Ayırıcı; yerel ayara, dışa aktaran uygulamaya ve verinin içeriğine bağlıdır. İşte en yaygın dört ayırıcı ve her birinin tipik olarak ne zaman kullanıldığı:

CSV ve JSON: Yapısal Farklılıklar

İki biçim arasındaki fark, dönüşüm sırasında başlık eşlemesinin, tür çıkarımının ve eksik değer işlemenin neden açık kararlar gerektirdiğini ortaya koymaktadır.

Kod Örnekleri

Popüler dillerde ve CLI araçlarında CSV'yi programatik olarak JSON'a nasıl dönüştüreceğiniz:

// Simple CSV string → JSON array
const csv = `name,age,city
Alice,30,Berlin
Bob,25,Tokyo`

const [headerLine, ...rows] = csv.trim().split('\n')
const headers = headerLine.split(',')
const json = rows.map(row => {
  const values = row.split(',')
  return Object.fromEntries(headers.map((h, i) => [h, values[i]]))
})
// → [{ name: "Alice", age: "30", city: "Berlin" }, ...]

// With the built-in fetch + a library (Papa Parse)
import Papa from 'papaparse'
const result = Papa.parse(csvString, { header: true, dynamicTyping: true })
console.log(result.data) // typed numbers and booleans

import csv, json, io

csv_string = """name,age,city
Alice,30,Berlin
Bob,25,Tokyo"""

reader = csv.DictReader(io.StringIO(csv_string))
data = [row for row in reader]
print(json.dumps(data, indent=2))
# → [{"name": "Alice", "age": "30", "city": "Berlin"}, ...]

# With type coercion (age as int)
import pandas as pd
df = pd.read_csv(io.StringIO(csv_string))
print(df.to_json(orient="records", indent=2))
# → [{"name": "Alice", "age": 30, "city": "Berlin"}, ...]

package main

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

func main() {
	input := "name,age,city\nAlice,30,Berlin\nBob,25,Tokyo"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()

	headers := records[0]
	var result []map[string]string
	for _, row := range records[1:] {
		obj := make(map[string]string)
		for i, h := range headers {
			obj[h] = row[i]
		}
		result = append(result, obj)
	}

	out, _ := json.MarshalIndent(result, "", "  ")
	fmt.Println(string(out))
	// → [{"age":"30","city":"Berlin","name":"Alice"}, ...]
}

# Using Miller (mlr) — handles quoting, types, and edge cases
mlr --icsv --ojson cat data.csv
# → [{"name": "Alice", "age": 30, "city": "Berlin"}, ...]

# Using csvjson from csvkit (Python-based)
csvjson data.csv

# Using jq with @csv (reverse: JSON → CSV)
# For CSV → JSON, pipe through Miller or Python
cat data.csv | python3 -c "
import csv, json, sys
reader = csv.DictReader(sys.stdin)
json.dump(list(reader), sys.stdout, indent=2)
"

Sıkça Sorulan Sorular