JSON na CSV

Przykład

Wejście:

[
  { "id": 1, "user": { "name": "Alice", "email": "a@a.com" }, "tags": ["admin"] },
  { "id": 2, "user": { "name": "Bob",   "email": "b@b.com" }, "tags": ["user", "beta"] }
]

Wynik (spłaszcz zagnieżdżone, połącz tablice):

id,user.name,user.email,tags
1,Alice,a@a.com,admin
2,Bob,b@b.com,"user,beta"

Wybór separatora

Zasady cytowania

Pole musi być ujęte w cudzysłów, gdy zawiera:

• separator
• podwójny cudzysłów (który jest cytowany przez podwojenie: " -> "")
• znak nowego wiersza

„Cytuj zawsze“ jest bezpieczniejsze dla zgodności między narzędziami; „cytuj tylko w razie potrzeby“ ułatwia ręczne czytanie pliku.

Obsługa zagnieżdżonych obiektów

• Spłaszcz: { user: { name: "A" } } staje się kolumną user.name. Głębokie ścieżki stają się a.b.c.d.
• Ciąg JSON: zagnieżdżony obiekt pozostaje jako jednokolumnowa wartość JSON: "{\"name\":\"A\"}". Przydatne, gdy narzędzia w dalszym ciągu potrafią ją sparsować.
• Konwersja na ciąg: łączy separatorem, tracąc strukturę.

Obsługa tablic

• Połącz: ["a", "b"] staje się "a,b" w jednej kolumnie.
• Kolumny indeksowane: tworzy tags.0, tags.1, tags.2, działa tylko, gdy długość tablicy jest spójna.
• Tylko pierwszy element: bierze tags[0] i ignoruje resztę.

Częste błędy

• Nierówne klucze między obiektami. Jeśli jeden obiekt ma phone, a inny nie, CSV dostaje kolumnę phone z pustymi komórkami dla brakujących wierszy. Zawsze waliduj, czy zestaw kluczy jest spójny.
• Zapomnienie o BOM dla Excela. Excel na Windowsie czyta CSV-y UTF-8 bez BOM jako Latin-1 i przekręca znaki z akcentami. Narzędzie oferuje przełącznik „dodaj prefiks BOM UTF-8“ na ten przypadek.
• Osadzanie znaków nowego wiersza w wartościach. Legalne w CSV zgodnym z RFC 4180, ale niektóre importery się na tym wykładają. Jeśli Twój cel jest delikatny, zastąp \n spacją lub tokenem \\n.
• Używanie Excela jako formatu pośredniego. Excel po cichu zamienia 007 na 7, ucina długie liczby i psuje wiodące zera w identyfikatorach. Dla integralności danych użyj CSV z porządnym parserem.