Belge · Veri · Geliştirici · Tarayıcıda

JSON ⇄ CSV Dönüştürücü ve Doğrulayıcı

JSON dizisini CSV'ye, CSV tablosunu JSON'a çevirin. İç içe nesneleri nokta notasyonuyla düzleştirin ve geri açın, ayırıcıyı (virgül, noktalı virgül, sekme) ve UTF-8 BOM'u seçin, JSON'u doğrulayıp hatanın satır ve sütununu görün, biçimlendirin ya da küçültün. Veri cihazınızdan çıkmaz.

Dosya ve metinler yalnızca tarayıcınızda işlenir; hiçbir yere gönderilmez.

Girdi

Çıktı

Kısaca: Metni yapıştırın ya da .json / .csv dosyası yükleyin; modu seçin. JSON → CSV'de başlıklar tüm kayıtların anahtar birleşiminden kurulur, iç içe alanlar adres.il gibi sütunlara düzleşir. CSV → JSON'da sayı, true/false ve null otomatik tanınır; adres.il başlıkları yeniden iç içe nesneye açılır. Geçersiz JSON'da hatanın tam yeri gösterilir.

Ne işe yarar?

Bir API yanıtını (JSON) elektronik tabloda açmak, bir tabloyu (CSV) uygulama ya da veritabanı içe aktarımı için JSON'a çevirmek, elle yazılmış bir JSON'daki yazım hatasını bulmak ve minimal ya da okunaklı hâle getirmek için kullanılır.

JSON → CSV nasıl çalışır?

Girdi kayıt dizisi (nesne dizisi), tek bir nesne, değer dizisi ya da dizi dizisi olabilir. Sütunlar, kayıtlardaki anahtarların ilk görülme sırasıyla birleşimidir; bir kayıtta olmayan anahtar boş hücre olur. Düzleştirme açıkken {"adres":{"il":"İzmir"}} kaydı adres.il sütununa, dizi öğeleri dizinle (etiketler.0) yazılır; dilerseniz diziler tek hücrede JSON metni olarak tutulur. Boş nesne ve boş dizi {} / [] metni olarak korunur. null boş hücre olur; sayı ve mantıksal değerler yazıya çevrilir.

CSV kuralları (RFC 4180)

Ayırıcı, çift tırnak ya da satır sonu içeren alan çift tırnak içine alınır; alan içindeki çift tırnak ikilenir (""). Satır sonu varsayılan olarak CRLF'dir, LF de seçilebilir. Excel'in Türkçe karakterleri doğru göstermesi için “UTF-8 BOM” seçeneğini açık tutun; Türkçe bölgesel ayarlı Excel çoğu kez noktalı virgül bekler. Okurken alanın içindeki satır sonları ve ikilenmiş tırnaklar doğru çözülür; tamamen boş satırlar atlanır.

CSV → JSON ve tür çıkarımı

İlk satır başlık ise her satır bir nesne olur; değilse dizi dizisi üretilir. Tür çıkarımı açıkken 12, 3.5, 1e3 sayıya; true/false mantıksala; null null'a; {…} ve […] biçimli geçerli JSON metinleri nesne/diziye dönüşür. Baştaki sıfırlı değerler (007) ve 16 basamak ve üzeri tam sayılar kesinlik kaybolmasın diye metin kalır. Boş hücreyi null, boş metin ya da hiç yazılmayan anahtar olarak seçebilirsiniz.

Doğrulama ve hata konumu

JSON, RFC 8259'a göre sıkı çözümlenir: sondaki virgül, tek tırnak, yorum ve kaçışsız satır sonu geçersizdir. Hata ayıklayıcı, sorunu satır ve sütunuyla ve ilgili satırın bir parçasıyla gösterir; “Hataya git” düğmesi imleci o konuma götürür.

Formül enjeksiyonu

Bir CSV'deki hücre =, +, -, @ ile başlıyorsa elektronik tablo programı onu formül sayabilir (OWASP: CSV injection). Güvenilmeyen veriyi dışa aktarırken ilgili seçeneği açın; bu hücrelerin başına kesme işareti konur.

Sınırlar

Anahtarında nokta bulunan alanlar düzleştirmede belirsizdir. JSON sayıları çift duyarlıklı okunur; 16 basamaktan uzun tam sayılarda kesinlik kaybolabilir (araç uyarır). Çok büyük dosyalar tarayıcı belleğini zorlar; 50 MB üstü kabul edilmez, 2 MB üstü için uyarı verilir.

Sık Sorulan Sorular

Verilerim bir sunucuya gidiyor mu?

Hayır. Metin ve dosyalar yalnızca tarayıcınızda işlenir; hiçbir yere gönderilmez.

İç içe nesneler CSV'ye nasıl dönüşür?

Düzleştirme açıkken adres.il gibi nokta notasyonlu sütunlar oluşur; dizi öğeleri etiketler.0 biçimindedir. CSV → JSON'da bu başlıklar yeniden iç içe nesneye açılır.

Excel'de Türkçe karakterler bozuluyor, ne yapmalıyım?

İndirirken “UTF-8 BOM ekle” seçeneğini açık tutun. Türkçe Excel noktalı virgül ayırıcı bekliyorsa ayırıcıyı noktalı virgül seçin.

Telefon numarası ya da 007 gibi değerler sayıya çevrilir mi?

Hayır. Baştaki sıfırlı değerler ve 16 basamak üstü tam sayılar tür çıkarımında metin olarak kalır. İsterseniz tür çıkarımını tamamen kapatabilirsiniz.

JSON hatasını nasıl bulurum?

Girdiyi yapıştırın; geçersizse hata mesajı, satır ve sütun numarası ve ilgili satır parçası gösterilir. Hataya git düğmesi imleci oraya götürür.

Yöntem ve kaynakça

JSON doğrulama: RFC 8259 dilbilgisine göre özyinelemeli bir çözümleyici hatanın bayt konumunu bulur (satır ve sütun bu konumdan hesaplanır); geçerli girdi tarayıcının JSON.parse işleviyle okunur. CSV okuma/yazma: RFC 4180 — alan içi ayırıcı, tırnak ve satır sonu için çift tırnak; çift tırnak ikileme; CRLF/LF/CR satır sonu okunur; alan başında olmayan çift tırnak olduğu gibi kabul edilir; tamamen boş satırlar atlanır. Ayırıcı otomatik algılamada ilk 20.000 karakterde adaylar (, ; sekme |) için tutarlı sütun sayısı veren satır adedi en yüksek olan seçilir.

Düzleştirme: nesne anahtarları nokta ile, dizi öğeleri dizinle birleştirilir; açarken nokta ile ayrılan ve tamamı sayıdan oluşan bölüm dizi dizini sayılır. Kodlama: dosyalar TextDecoder ile UTF-8, windows-1254 ya da windows-1252 olarak çözülür (WHATWG Encoding). Formül koruması: OWASP önerisi.

  1. Shafranovich, Y. (2005). RFC 4180: Common Format and MIME Type for Comma-Separated Values (CSV) Files. Internet Engineering Task Force. https://www.rfc-editor.org/rfc/rfc4180
  2. Bray, T. (ed.) (2017). RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format. Internet Engineering Task Force. https://www.rfc-editor.org/rfc/rfc8259
  3. Ecma International. ECMA-262: ECMAScript Language Specification — JSON nesnesi (JSON.parse ve JSON.stringify). https://tc39.es/ecma262/#sec-json-object
  4. WHATWG. Encoding Standard — UTF-8 çözme, BOM işleme ve windows-1254 / windows-1252 kodlamaları. https://encoding.spec.whatwg.org/
  5. OWASP. CSV Injection (formül enjeksiyonu): =, +, -, @ ile başlayan hücreler. https://owasp.org/www-community/attacks/CSV_Injection

Son güncelleme: 2026-11-16

← Kaynaklara Dön

© 2026 Abdullah Çetin. Bu aracın kodu, tasarımı ve içeriği telif hakkıyla korunur; izinsiz kopyalanması, çoğaltılması veya başka bir sitede kullanılması yasaktır.