CSV ↔ JSON Çevirici

CSV ile JSON arasında çift yönlü dönüşüm, header destekli

Ayraç

İlk satır başlık

CSV

JSON

Nasıl çalışır

CSV ↔ JSON Çevirici — CSV ile JSON arasında çift yönlü dönüşüm, header destekli. Tüm işlemler tarayıcında yapılır — yükleme yok, üyelik yok, e-posta gerek yok. Sonsuza dek ücretsiz.

Son güncelleme: 2026-05-06

Editör notu

Bunu yaptık çünkü "ilk satır başlık" sorusuna her CSV aracı bariz muamelesi yapıyor; oysa gerçek veride yarı yarıya yanlış çıkıyor — banka export'ları başta bir metadata satırıyla geliyor, analitik dump'ları her sayfa kırılmasında başlığı tekrar yazıyor ve şaşırtıcı sayıda dahili sistem gerçek kolonlardan önce boş bir satır yolluyor. Delimiter tespitini ve başlık toggle'ını öne çıkarıyoruz; tam dosya dönüşmeden önce override edebileceğin opinionated tahminler olarak — çünkü 50.000 satırlık bir parse'tan sonra her kolonun bir sıra kaydığını fark etmek bu dersi öğrenmenin en kötü yolu.

Dosyayı upload etmeyi de reddediyoruz. CSV'ler gerçek kullanıcı verisinin yaşadığı yerdir: adresler, telefon numaraları, email adresleri, işlem geçmişleri, bazen birinin export'tan önce maskelemeyi unuttuğu bir kolon. Diğer dönüştürücüler dosyayı seve seve bir sunucuya POST edip buna feature diyor; biz Papa Parse'ı tarayıcıda çalıştırıyoruz ve byte'lar sekmeden çıkmıyor. PII içeren bir CSV dönüştürüyorsan, privacy özelliğinin demir gibi olması gereken an tam olarak orası — privacy policy'nin dipnotu değil.

CSV ↔ JSON Çevirici hakkında

CSV en küçük ortak payda veri formatıdır: her spreadsheet, her database export aracı, her legacy sistem konuşur. JSON ise modern API'lerin ve JavaScript kodunun lingua franca'sıdır. İkisi arasında dönüşüm; analiz dump'ları import eden, spreadsheet'ten database seed'leyen ya da anket sonuçlarını web app'e pipe eden herkes için günlük bir iş — ama tırnaklı alanlar, gömülü virgüller ve virgül dışı ayraçlarla doğru yapmak şaşırtıcı kadar zahmetli.

Bu çift yönlü dönüştürücü köşe vakaları otomatik halleder. CSV → JSON yönü RFC 4180 tırnaklamasına uyar (tırnaklı bir alandaki virgül tek alan kalır), Avrupa ";" ve tab ayraçlı dosyalar için custom delimiter destekler ve istediğinde ilk satırı object key olarak kullanır. JSON → CSV yönü bir nesne dizisini alır, tüm anahtarların birleşimini header satırı olarak kullanan düzgün tırnaklı bir CSV üretir; eksik alanlar sessiz kayma yerine boş hücre olur.

Her şey tarayıcında çalışır. Dosya 100 satırlık demo da olsa, PII içeren 50.000 satırlık bir export da olsa veri makineninde kalır. Söz konusu CSV içinde yüklenmemesi gereken gerçek kullanıcı verisi varsa bu privacy özelliği önemlidir.

CSV ↔ JSON Çevirici nasıl kullanılır

CSV'ni CSV tarafına veya JSON dizini JSON tarafına yapıştır.
Delimiter'ı ayarla: "," (default), Avrupa CSV'leri için ";", TSV için "\t" veya başka tek karakter.
CSV sütun adlarının JSON object key olmasını istiyorsan "İlk satır başlık" toggle'ını aç.
Yöne göre "CSV → JSON" veya "JSON → CSV" düğmesine bas.
"Geçersiz CSV" veya "JSON nesne dizisi olmalı" mesajı görüyorsan input şeklini düzelt ve tekrar dene.
Dönüştürülmüş çıktıyı veri import aracına, kod editörüne veya test fixture dosyana kopyala.

Yaygın kullanım senaryoları

Bir spreadsheet export'unu typed nesne dizisi olarak JavaScript app'ine veya test fixture'ına aktarmak.
Teknik olmayan paydaşlar için bir JSON API yanıtından CSV üretmek.
Biri yalnızca CSV export, diğeri yalnızca JSON kabul eden iki sistem arasında veri taşımak.
Avrupa ";" ayraçlı bir CSV'yi, önce Excel'de açıp virgülle yeniden kaydetmeden JSON'a çevirmek.
TSV log dump'ını jq'dan geçirip JavaScript ile sorgulamak için JSON olarak hızlıca incelemek.

İpuçları ve dikkat edilmesi gerekenler

CSV alanlarında metnin içinde virgül varsa, alan çift tırnağa sarılmalıdır (RFC 4180). Tırnaksız virgüller sütun sınırı olarak parse edilir.
Excel, ondalık ayracı virgül olan sistemlerde (Türkiye dahil çoğu Avrupa) genellikle ayracı ";" yapar. CSV'n tek dev sütun gibi görünüyorsa Delimiter'ı buna göre ayarla.
JSON → CSV düz bir nesne dizisi ister. Nested nesneler "[object Object]" hücresine dönüşür — önce flatten et veya nested alanları stringify et.
Sayı gibi görünen string'ler ("007", "+90 555…") sessizce sayıya coerce edilebilir ve baştaki sıfırlar kaybolabilir. Güvenli olmak için kaynak CSV'de bu sütunları tırnak içine al.

Sıkça sorulan sorular

Tırnaklı alanlar ve gömülü virgüller işleniyor mu?

Evet. Parser'ımız RFC 4180 tarzı tırnaklamayı destekler: alan içinde escape'lenmiş çift tırnak (""") ve tırnaklı string'ler içinde virgül/newline.

Virgül dışında ayraç kullanabilir miyim?

Evet. Ayracı ; (noktalı virgül), \t (tab), |, veya tek karakter olarak set edebilirsin. Avrupa CSV exportları için kritik (varsayılan ;).

JSON → CSV neden nesne dizisi gerektiriyor?

Her nesne bir CSV satırı olur, anahtarlar başlığı oluşturur. Tüm anahtarların birleşimini topluyoruz; eksik alanlar boş hücre olur.

CSV alanlarının içindeki satır sonları nasıl işleniyor?

Alan çift tırnak içine alınmışsa (RFC 4180 gereği), gömülü satır sonları değerin parçası olarak korunur. Tırnaksız satır sonları her zaman satırı bitirir.

Derinlemesine nested JSON'ı CSV'ye çevirebilir miyim?

Doğrudan değil — CSV düz tablo formatıdır. Nesneleri (örn. "address.city" tek sütun) flatten et veya nested alanları stringify et; her biri JSON-encoded hücre olur.

JSON çıktısı CSV'deki sütun sırasını koruyor mu?

Evet. JSON nesneleri header satırındaki sütun sırasını kullanır, dolayısıyla Object.keys() ile dönen aşağı akış kodu kaynak CSV'yle aynı sırayı görür.

Blogdan son yazılar

JSON, YAML, CSV: Hangi Veri Formatını Ne Zaman Kullanmalı?JSON, YAML ve CSV birbirine benzeyen sorunları çözer ama aynı iş için tasarlanmadılar. Bu yazıda söz dizimi, dosya boyutu, gerçek dünya kullanımları ve sizi geceleri uyandıran tuzaklar üzerinden hangi formatı ne zaman seçeceğinizi inceliyoruz.