Как пользоваться

Вставьте массив объектов JSON, откройте файл .json или нажмите «Попробовать пример».
Выберите разделитель для вашей табличной программы и способ записи массивов внутри объектов.
Проверьте предварительный просмотр CSV. Каждый объект — отдельная строка, а вложенные поля становятся столбцами, например address.city.
Скопируйте CSV или скачайте его как файл .csv.

Как это работает

Каждый элемент массива верхнего уровня становится отдельной строкой. Столбцы включают все ключи и располагаются в порядке их первого появления, поэтому объекты с разными полями всё равно будут правильно выровнены. Если поля нет или его значение равно null, ячейка будет пустой. Вложенные объекты преобразуются в столбцы с точечными путями: {"address": {"city": "Oslo"}} превращается в столбец address.city. Если в корне находится один объект, результатом будет одна строка. Массивы простых значений (например, [1, 2, 3]) преобразуются в один столбец с именем value.

Массивы внутри объектов можно записать тремя способами: как текст JSON в одной ячейке (["a","b"]), объединив значения в одной ячейке (a; b) или распределив их по пронумерованным столбцам (tags.0, tags.1). Последний вариант удобен, если в каждой строке похожий короткий список.

Результат соответствует RFC 4180: поле заключается в двойные кавычки, если в нём есть разделитель, двойная кавычка или перенос строки; кавычки внутри поля удваиваются. Строки разделяются переносами CRLF. Во многих европейских региональных настройках Excel ожидает точку с запятой вместо запятой, поскольку запятая используется как десятичный разделитель. При открытии CSV-файла Excel может также изменить длинные числа, начальные нули и текст, похожий на дату; если важно сохранить точные значения, импортируйте файл как текст. При разборе JSON числа больше 2^53 теряют точность.

Примеры

Экспорт пользователей из API

API возвращает [{"id":1,"name":"Ada","address":{"city":"London"}}, …]. В CSV будут столбцы id, name и address.city — данные можно сразу сортировать и фильтровать в таблице.

Текст с запятыми и кавычками

Имя Alan "AT" Turing преобразуется в "Alan ""AT"" Turing", а название города Wilmslow, Cheshire заключается в кавычки. Так табличные редакторы сохраняют каждое значение в своей ячейке.

Открытие в Excel на немецком или французском

Выберите точку с запятой в качестве разделителя и включите BOM UTF-8. Тогда Excel правильно разделит столбцы и отобразит символы ä и é без искажений.

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

Что происходит с глубоко вложенным JSON?

Вложенные объекты на любой глубине преобразуются в столбцы с точечными путями, например order.customer.address.zip. Для массивов используйте выбранный вариант: текст JSON, объединённые значения или отдельный столбец для каждого элемента.

Почему некоторые ячейки пустые?

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

Какой разделитель выбрать?

Стандартный разделитель — запятая. Используйте точку с запятой для Excel в регионах, где десятичные дроби записывают через запятую (в большей части Европы и Латинской Америки), а табуляцию — если в данных много запятых или нужно сразу вставить их в таблицу.

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

Да, с помощью конвертера CSV в JSON на этом сайте. Обратите внимание: преобразование с уплощением не полностью обратимо — имена столбцов с точечными путями вернутся как обычные ключи, например "address.city", а не как вложенные объекты.

Конфиденциальность

Преобразование выполняется в браузере. Ваши JSON и CSV не загружаются на сервер, не сохраняются и не передаются в аналитику.