JSON'dan CSV'ye Dönüştürücü

CSV nedir ve neden JSON'dan dönüştürülür?

// Input JSON
[
  { "id": 1, "name": "Alice", "role": "admin" },
  { "id": 2, "name": "Bob", "role": "editor" }
]

// Output CSV (RFC 4180 preset: comma + CRLF + no BOM)
id,name,role
1,Alice,admin
2,Bob,editor

// Same input with Stringify mode + nested data
[
  { "id": 1, "tags": ["a", "b"] }
]

// Becomes
id,tags
1,"[""a"",""b""]"

Temel Özellikler

Örnekler

[{"id":1,"name":"Alice Chen","email":"alice@example.com","role":"admin"},{"id":2,"name":"Bob Garcia","email":"bob@example.com","role":"editor"},{"id":3,"name":"Carol Singh","email":"carol@example.com","role":"viewer"},{"id":4,"name":"Dan Müller","email":"dan@example.com","role":"viewer"}]

[{"id":1001,"title":"Bug: login redirects to 404","state":"open","labels":["bug","priority:high"],"user":{"login":"alice"}},{"id":1002,"title":"Feature: dark mode toggle","state":"open","labels":["enhancement"],"user":{"login":"bob"}},{"id":1003,"title":"Docs: update README","state":"closed","labels":["docs","good-first-issue"],"user":{"login":"carol"}}]

[{"_id":{"$oid":"6634a1b2c3d4e5f600000001"},"email":"alice@example.com","metadata":{"signupDate":"2026-01-15T10:30:00Z","preferences":{"newsletter":true,"theme":"dark"}}},{"_id":{"$oid":"6634a1b2c3d4e5f600000002"},"email":"bob@example.com","metadata":{"signupDate":"2026-02-20T14:15:00Z","preferences":{"newsletter":false,"theme":"light"}}}]

{"event":"signup","user":"alice","ts":1715000000}
{"event":"login","user":"alice","ts":1715000060}
{"event":"checkout","user":"alice","ts":1715000300}

[{"id":"ord-001","customer":{"name":"Alice Chen","email":"alice@example.com","address":{"city":"Seattle","country":"US"}},"items":[{"sku":"SKU-100","qty":2},{"sku":"SKU-205","qty":1}]},{"id":"ord-002","customer":{"name":"Bob Garcia","email":"bob@example.com","address":{"city":"Madrid","country":"ES"}},"items":[{"sku":"SKU-100","qty":1}]}]

[{"name":"GET /users returns 200","status":"pass","duration":142},{"name":"POST /users creates record","status":"pass","duration":287},{"name":"GET /users/999 returns 404","status":"fail","duration":98,"error":"Expected 404, got 500"},{"name":"DELETE /users/1 returns 204","status":"pass","duration":156}]

Nasıl Kullanılır

1. 1

   JSON'unuzu yapıştırın

   JSON'unuzu yukarıdaki giriş alanına girin veya yapıştırın. Araç; nesne dizilerini, tek nesneleri ve NDJSON'u (satır ayrılmış JSON) kabul eder — otomatik olarak algılanır. REST API yanıtı, MongoDB dışa aktarımı veya NDJSON olay günlüğü gibi bir örnek denemek için «Örnek yükle» düğmesine de tıklayabilirsiniz.

2. 2

   Bir ön ayar seçin (veya Seçenekleri ayarlayın)

   Tek tıkla hedef biçimi belirlemek için RFC 4180 (varsayılan), Excel (EU noktalı virgül + BOM), TSV (Tab) veya Pipe'a tıklayın. İnce denetim için Seçenekler panelini açın: Ayırıcı, Başlık, Tırnak (Otomatik/Her zaman), Satır sonu (LF/CRLF), BOM ve İç içe (Düzleştir/Stringify).

3. 3

   CSV'yi Kopyalayın veya İndirin

   CSV'yi panonuza almak için Kopyala'ya veya Excel, Google E-Tablolar, PostgreSQL COPY ya da herhangi bir veri hattı için hazır bir .csv (TSV ön ayarıyla .tsv) dosyası olarak kaydetmek için İndir'e tıklayın. Gidiş-dönüşler için CSV'yi yerinde JSON'a dönüştürmek üzere Yönü değiştir'e tıklayın.

Yaygın Dönüştürme Tuzakları

42

[{"value": 42}]

[
  {"name": "GET /users", "status": "pass"},
  {"name": "GET /users/999", "status": "fail", "error": "500"}
]

// Output CSV (note empty cell in row 1)
name,status,error
GET /users,pass,
GET /users/999,fail,500

{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

{"id": "9007199254740993"}
// CSV preserves the string; Excel displays exactly

name,role
Smith, Jr.,admin
// Parser reads 3 columns: "Smith", " Jr.", "admin"

name,role
"Smith, Jr.",admin
// Parser reads 2 columns: "Smith, Jr.", "admin"

id,name,price
1,Alice,1,234.56
// Excel-EU mis-parses 1,234.56 as two columns

// Excel preset output: ; + CRLF + BOM
id;name;price
1;Alice;1234,56
// Excel-EU reads cleanly with comma decimal

[
  {"event": "signup"},
  {"event": "login"}
]
// Detected as a regular JSON array (works, but not NDJSON path)

{"event": "signup"}
{"event": "login"}
// Each line is one JSON value — auto-detected as NDJSON

Yaygın Kullanım Senaryoları

API Yanıtından Elektronik Tabloya

Bir REST API yanıtını (kullanıcı/sipariş/olay nesnesi dizisi) yapıştırın ve Excel, Google E-Tablolar veya Numbers için hazır temiz bir tablo CSV'si alın. En yaygın kullanım senaryosu — analistler ve ürün yöneticileri elektronik tablo biçiminde veri ister, mühendisler arka uçtan JSON gönderir.

MongoDB Dışa Aktarımından Veri Ambarına

mongoexport JSON çıktısını ($oid sarmalayıcıları ve iç içe metadata belgeleri içeren) BigQuery, Snowflake veya Redshift'e yüklemek için CSV'ye dönüştürün. Stringify modu, alt akış araçları hücre içinde JSON'u desteklediğinde iç içe biçimi kayıpsız korur.

GitHub Issues Önceliklendirme

/repos/{owner}/{repo}/issues uç noktasından konuları çekin, JSON'u yapıştırın ve id, title, state, labels ile user.login sütunlarına sahip düz bir CSV alın. Sprint planlamada filtrelemek, sıralamak ve atamak için Sheets'e bırakın.

NDJSON Olay Günlüğü İncelemesi

Cloud Logging, Datadog, Vector veya kendi hattınızdan gelen akış günlükleri çoğunlukla NDJSON (.ndjson, .jsonl) olarak gelir. Dosya içeriğini doğrudan yapıştırın — otomatik olarak algılanır — ve gerçek bir ETL hattı kurmadan anlık analiz için bir CSV elde edin.

E-Ticaret Sipariş Çıkarma

İç içe sipariş JSON'unu (customer.address.city, items dizisi) finans, sipariş yerine getirme veya dolandırıcılık incelemesi için düz bir CSV'ye dönüştürün. Düzleştir modu, anlık raporlama için Excel'e yüklemeye hazır, yaprak alan başına bir sütun üretir.

Postman/Newman Test Raporu

Postman test dışa aktarımları karışık biçimli satırlar içerir (bazıları isteğe bağlı error alanlarına sahiptir). JSON'u yapıştırın, tüm anahtarları birleştirilmiş ve eksik hücreleri doldurulmuş bir CSV alın — başarısız test raporlarını Sheets üzerinden mühendis olmayanlarla paylaşmak için mükemmeldir.

Teknik Ayrıntılar

RFC 4180 Durum Makinesi Ayrıştırıcısı

Her iki yön de RFC 4180'i izleyen uygun bir sonlu durum makinesi ayrıştırıcısı kullanır. Durumlar arasında UnquotedField, QuotedField, AfterQuote, RowEnd ve EndOfInput yer alır. Ayrıştırıcı; ayırıcıyı içeren tırnaklanmış alanları, tırnaklanmış alanlardaki gömülü CR/LF'yi, kaçırılmış çift tırnakları (ikiye katlanmış, "" gibi) ve sondaki yeni satırları doğru biçimde işler. Bu, Python'un csv modülü, PostgreSQL COPY, AWS S3 SELECT ve uyumlu herhangi bir ayrıştırıcı üzerinden kayıpsız gidiş-dönüş yapan çıktı üretir.

Büyük Tam Sayı Algılama Algoritması

JSON'u JSON.parse() üzerinden geçirmeden önce (büyük tam sayıları IEEE 754 üzerinden sessizce yuvarlardı), araç ham JSON metni üzerinde güvenli aralığın (-2^53+1 ila 2^53-1) dışındaki tam sayı değişmezlerini arayan bir regex taraması çalıştırır. Algılandığında etkilenen alan yolları kaydedilir ve çıktının altında bir Büyük tam sayı uyarı başlığı belirir. CSV yazıcı daha sonra bu değerleri dize olarak korur; bu da Excel, Google E-Tablolar ve metin farkındalı her alt akış tüketicisinde tam hassasiyet sağlar.

Excel için BOM ve UTF-8 Kodlaması

Tüm girdi ve çıktı UTF-8'dir. BOM düğmesi açıkken veya Excel ön ayarı seçildiğinde isteğe bağlı UTF-8 BOM (0xEF 0xBB 0xBF) çıktının başına eklenir. Windows'taki Excel UTF-8 kodlamasını algılamak için BOM kullanır — onsuz Excel sistem yerel ayarına geri döner (ABD'de Windows-1252, Rusya'da Windows-1251 vb.) ve ASCII olmayan karakterleri bozar. Modern ayrıştırıcılar (Python csv, Pandas, jq, PostgreSQL) genellikle BOM'a ihtiyaç duymaz ve onu ilk hücrenin başında bir kaçak karakter olarak dahil edebilir; bu nedenle Excel dışı hatlar için BOM'u kapalı bırakın.

En İyi Uygulamalar

Seçenekleri Ayarlamadan Önce Bir Ön Ayar Seçin

RFC 4180, Excel, TSV ve Pipe ön ayarları beş seçeneği aynı anda ayarlar (ayırıcı, satır sonu, tırnak modu, BOM, başlık). Önce en yakın ön ayarı seçin, ardından yalnızca gerekiyorsa tek tek seçenekleri ince ayarlayın — bu, bir seçeneği değiştirip diğerini unutma yaygın hatasından kaçındırır (örneğin noktalı virgüle geçip LF bırakmak; Windows'taki Excel-EU bunu hâlâ yanlış ayrıştırır).

Analiz için Düzleştir, Gidiş-Dönüş için Stringify

Hedef Excel, Sheets veya tek seferlik bir analiz olduğunda Düzleştir'i kullanın — noktalı anahtarlar en temiz elektronik tablo düzenini üretir. Veri kaybı olmadan CSV → JSON → CSV gidiş-dönüşüne ihtiyacınız olduğunda Stringify'ı kullanın — dizi ve nesneler tek hücre içinde JSON olarak hayatta kalır. Dışa aktarımın ortasında geçiş yapıp yeniden çalıştırmak ucuzdur; tüketiciye göre seçim yapın.

BOM'u Yalnızca Excel için Kullanın

UTF-8 BOM, Windows'taki Excel'in kodlamayı doğru algılaması için gereklidir. Diğer her ayrıştırıcı (Python csv, Pandas, jq, PostgreSQL COPY, BigQuery) ya BOM'u yok sayar ya da ilk hücrenin başında bir kaçak karakter olarak dahil edip sütun adlarını bozar. Hatlar için BOM'u kapalı bırakın ve yalnızca hedef Excel olduğunda açın (veya Excel ön ayarını kullanın).

Büyük ID'leri JSON'da Dize Olarak Saklayın

Twitter snowflake ID'leri, Discord ID'leri, MongoDB Long alanları ve K8s resourceVersion, JavaScript'in güvenli aralığını (2^53 - 1) aşan 64 bitlik tam sayılardır. Dönüştürmeden önce bunları JSON dizesi olarak saklayın ("id": "9007199254740993") — CSV rakamları birebir korur; oysa sayısal bir değişmez JSON.parse() tarafından sessizce yuvarlanırdı.

Yüklemeden Önce Satır Biçimini Doğrulayın

Karışık biçimli satırlar (bazı nesnelerde olup diğerlerinde olmayan anahtarlar) çıktıda boş hücrelerle birleştirilir ve araç bir Şema notları uyarısı gösterir. Katı şemalı tüketiciler (BigQuery, Redshift COPY) için dışa aktarmadan önce tüm satırların aynı anahtarları paylaştığını doğrulayın — ya da hattınızda eksik değerleri açıkça ele alın. Önce girdi biçimini incelemek için JSON Biçimlendirici aracımızı kullanın.

Sıkça Sorulan Sorular