JSON в CSV

Пример

Ввод:

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

Выход (расплющивание вложенных массивов и объединение массивов):

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

Выбор разделителя

Правила цитирования

Поле необходимо указывать в кавычках, если оно содержит следующее:

• разделитель
• двойные кавычки (экранируются удвоением: " → "")
• перевод строки

Формат «Всегда цитировать» обеспечивает лучшую совместимость с различными инструментами; формат «Цитировать только при необходимости» упрощает ручное чтение файла.

Обработка вложенных объектов

• Сглаживание: объект { user: { name: "A" } } преобразуется в столбец user.name; глубокие пути, в a.b.c.d.
• JSON-строка: вложенный объект сохраняется в виде значения JSON в одном столбце (например, "{\"name\":\"A\"}"). Это удобно, если последующие инструменты могут его обрабатывать.
• Преобразование в строку: объединяет значения через разделитель, теряя структуру.

Обработка массивов

• Соединить: значение ["a", "b"] преобразуется в "a,b" в одном столбце.
• Индексированные столбцы: создают значения tags.0, tags.1, tags.2; работает только при одинаковой длине массивов.
• Только первый элемент: берёт только значение tags[0] и игнорирует остальные.

Распространённые ошибки

• Несогласованные ключи в разных объектах. Если у одного объекта есть ключ phone, а у другого, нет, в CSV появится столбец phone с пустыми ячейками для строк, где значение отсутствует. Всегда проверяйте, что набор ключей согласован.
• Забытый BOM для Excel. Excel в Windows считывает CSV-файлы в UTF-8 без BOM как Latin-1 и искажает символы с диакритикой. Инструмент предлагает параметр «Добавить префикс UTF-8 BOM» для этого случая.
• Перевод строки внутри значений. Допустимо по стандарту RFC 4180 для CSV, однако некоторые импортёры с этим не справляются. Если целевая система чувствительна, замените \n на пробел или токен \\n.
• Использование Excel как формата для обратного преобразования. Excel молча конвертирует 007 в 7, обрезает длинные числа и портит ведущие нули в идентификаторах. Для сохранения целостности данных используйте CSV с подходящим парсером.