Конвертер JSON в CSV

Конвертируйте JSON в CSV, разворачивайте вложенные значения, просматривайте строки и скачивайте результат.

Advanced settings
Записи
Массивы
Вывод CSV

Конвертация JSON в CSV за три шага

  1. Добавьте данные JSON. Вставьте объект или массив, или загрузите поддерживаемый файл .json.
  2. Выберите правила конвертации. Укажите массив записей, разделитель, поведение заголовка и параметры вложенных данных.
  3. Проверьте и экспортируйте. Просмотрите таблицу, скопируйте текст CSV или скачайте файл .csv.

Структуры JSON, которые принимает этот инструмент

Массив объектов

Массив объектов — самый понятный источник для CSV, потому что каждый объект становится одной строкой.

[
  {"id": 1, "name": "Ада"},
  {"id": 2, "name": "Лин"}
]

Ключи становятся столбцами, а объекты — строками.

Одиночный объект

Одиночный плоский объект становится одной строкой CSV. Если объект содержит вложенный массив записей, инструмент позволяет выбрать этот массив как источник записей.

{
  "results": [
    {"id": 1, "status": "active"},
    {"id": 2, "status": "paused"}
  ],
  "count": 2
}

Выбор results создает две строки. Значение обертки count не превращается в третью запись.

Объекты с разными ключами

Реальные массивы JSON не всегда содержат одинаковые объекты. Конвертер строит объединение ключей по выбранным записям.

[
  {"id": 1, "email": "[email protected]"},
  {"id": 2, "phone": "555-0100"}
]

CSV содержит столбцы id, email и phone, с пустым значением, если запись не содержит этого ключа.

Разворачивание вложенного JSON

Вложенные объекты не могут напрямую поместиться в обычные столбцы CSV. Этот инструмент разворачивает базовые пути объектов в имена столбцов.

{
  "user": {
    "name": "Ада",
    "address": {
      "city": "Лондон"
    }
  }
}

Предлагаемые столбцы:

user.name
user.address.city

Панель параметров включает разворачивание вложенных объектов (вкл/выкл), разделитель пути, максимальную глубину разворачивания и поведение после достижения максимальной глубины.

Выбор способа записи массивов

Массивы требуют осознанного правила вывода, потому что одна ячейка CSV не может естественно представить повторяющиеся структурированные записи.

  • Объединить примитивные значения: ["red","blue"] становится red, blue.
  • Оставить как JSON: сохранить полный текст массива в одной экранированной ячейке.
  • Оставить пустым: доступно только как явный выбор пользователя, никогда не является молчаливым значением по умолчанию.

Параметры вывода CSV

Разделитель

Выберите запятую, точку с запятой, табуляцию, вертикальную черту или поддерживаемый пользовательский одиночный символ. Выбранный разделитель применяется одинаково к заголовку и каждой строке.

Строка заголовка

По умолчанию вывод включает имена столбцов. Переключатель убирает заголовок для систем, которые принимают только необработанные строки.

Кавычки

Значения CSV, содержащие разделитель, кавычку или перевод строки, экранируются правильно. Литеральные кавычки внутри экранированного поля экранируются.

  • минимальное экранирование
  • экранировать все поля
  • конец строки
  • включить BOM UTF-8 при необходимости для совместимости с электронными таблицами

Пустые и null значения

Выберите, как представлять null, отсутствующие ключи и пустые строки: пустая ячейка, литерал null или пользовательский заполнитель. Предпросмотр делает различие видимым перед скачиванием.

Предпросмотр сгенерированного CSV

Предпросмотр показывает обнаруженное количество записей, количество сгенерированных столбцов, выбранный путь записей и предупреждения о несоответствии форм объектов или вложенных массивов, а также табличное представление первых отображаемых строк. Необработанный вывод CSV доступен, когда вам нужно проверить экранирование.

Частые проблемы при конвертации JSON в CSV

На выходе только одна строка

Вероятно, выбранное значение JSON — это одиночный объект, а не массив записей. Выберите вложенный массив, содержащий записи.

Вложенные поля отсутствуют

Включите разворачивание или выберите «оставить вложенное значение как JSON». Инструмент предупреждает, когда значение превышает настроенную глубину разворачивания.

В некоторых строках пустые ячейки

Объекты JSON содержат разные ключи или отсутствующие значения. CSV требует один общий набор столбцов, поэтому отсутствующие значения становятся пустыми ячейками или выбранным заполнителем.

Массивы нечитаемы в Excel

Измените стратегию работы с массивами. Объединяйте примитивные значения для простых тегов или сохраняйте исходный массив как компактный JSON, когда структура важна.

Символы с диакритикой выглядят неправильно

Скачайте с настройками, совместимыми с UTF-8, и откройте файл с правильной кодировкой. Если есть опция BOM, она меняет только префикс байтов; она не перекодирует содержимое.

Часто задаваемые вопросы о JSON в CSV

Может ли этот конвертер обрабатывать вложенный JSON?

Да, для поведения разворачивания, реализованного на панели параметров. Ключи вложенных объектов могут стать столбцами на основе пути. Вложенные массивы требуют отдельной стратегии работы с массивами.

Как создаются заголовки CSV?

Конвертер строит заголовки из ключей, найденных в выбранных записях. Когда записи имеют разные ключи, объединение этих ключей становится полным набором заголовков.

Что происходит с массивами JSON?

Примитивные массивы можно объединить или сохранить как текст JSON. Массивы объектов сохраняются как JSON, а не объединяются в непригодный текст.

Сохраняются ли числа и логические значения?

Их текстовое представление записывается в CSV. Сам CSV не сохраняет типы JSON, поэтому дальнейшее программное обеспечение решает, как интерпретировать каждую ячейку.

Загружается ли JSON?

Нет — данные, которые вы вставляете, обрабатываются полностью в вашем браузере. Файлы, превышающие лимит обработки браузера, предлагаются как необязательный серверный запасной вариант, и ничего не загружается без вашего согласия.

Можно ли конвертировать JSON обратно из CSV?

Да. Используйте конвертер CSV в JSON и выберите параметры заголовка и определения типов, соответствующие файлу.