JSON в CSV: массив объектов в таблицу для Excel

JSON в CSV нужен, когда ответ API или лог лежит массивом объектов, а смотреть и фильтровать удобнее в таблице. Каждый объект становится строкой, ключи верхнего уровня становятся колонками. Вложенные объекты в отдельные столбцы сами не разворачиваются: для плоской таблицы лучше отдавать уже плоский JSON. В русском Excel часто нужен разделитель «;», а не запятая. Откройте JSON в CSV на Тулси: вставьте текст или загрузите файл, выберите разделитель, скопируйте или скачайте результат. Обработка идёт в браузере на вашем устройстве, без отправки данных на сервер. Ниже: когда конвертация ломается, как подготовить массив, путь в инструменте и соседние утилиты CSV в Excel и JSON formatter. Частые вопросы собраны в конце.

Почему JSON неудобно открывать как таблицу

JSON хранит данные деревом: объекты, массивы, вложенность. Excel и Google Таблицы ждут плоскую сетку: заголовок в первой строке, дальше одно значение на ячейку. Если вы просто сохраните .json и откроете его как текст, столбцы не появятся.

Люди ищут «json в csv», когда нужно выгрузить ответ API, список заказов или лог событий в файл, который откроется в таблице. Соседние формулировки «преобразовать json в csv» и «конвертировать json в csv» ведут к той же задаче: из массива объектов собрать CSV.

Типичный исходник: массив вида [{ "id": 1, "name": "A" }, { "id": 2, "name": "B" }]. Здесь всё просто: две строки, две колонки. Сложность начинается, когда поля различаются по объектам или внутри ключа лежит ещё один объект.

Когда без конвертера не обойтись

Большой ответ из DevTools: тысяча символов в одну строку, глазами столбцы не соберёте. Скрипт на Python для разовой выгрузки писать долго. Нужен файл коллеге, который работает только в Excel.

В этих случаях быстрее вставить JSON в конвертер в браузере, получить CSV и открыть его в таблице. Для постоянного пайплайна уже пишут код; для разовой выгрузки хватает вкладки на Тулси.

Чем JSON отличается от готовой таблицы

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

Вложенность. Поле address: { "city": "Казань" } нельзя читать как одну ячейку «город»: это вложенный объект. Без предварительного «выпрямления» в CSV вы получите либо строку-объект целиком, либо пропуск глубоких полей. Для отчёта лучше заранее сделать плоский JSON с ключами вроде city.

Что можно сделать самому до браузера

Иногда конвертация не нужна. Если массив короткий, три поля, вы можете вручную набросать таблицу в Excel. Если исходник битый, сначала чините синтаксис, иначе CSV не соберётся.

Держите в голове два шага: валидный JSON и плоская структура. Без первого конвертер откажется разбирать текст. Без второго таблица будет неполной или с «кашей» в ячейках.

Локально можно написать пару строк на Python или открыть JSON в редакторе с плагином. Для куска из тикета или чата быстрее вкладка на сайте: без установки и сохранения промежуточных скриптов.

Проверка синтаксиса до конвертации

Скопируйте фрагмент целиком: от первой [ или { до парной закрывающей скобки. Если парсер ругается, сначала откройте JSON formatter: режим «Красиво» покажет, где сломаны скобки или запятые. Разбор ошибок: как найти ошибку в JSON.

Не вставляйте в конвертер лог с префиксом времени и уровнем INFO. Не оставляйте комментарии //: в JSON их нет. «Умные» кавычки из мессенджера замените на обычные ".

Когда достаточно редактора и скрипта

Если вы каждый день гоняете один и тот же API в отчёт, имеет смысл закрепить скрипт в репозитории. Разовая выгрузка на десять строк это другой сценарий: копирование в JSON в CSV займёт меньше времени, чем настройка окружения.

Для файла уже в CSV, который Excel открывает «иероглифами», конвертер JSON не поможет. Там другой инструмент: CSV в Excel и статья про кодировку CSV в Excel без иероглифов.

Как подготовить JSON перед вставкой

Качество таблицы зависит от формы исходника. Лучший вариант: массив объектов с одинаковым набором ключей на верхнем уровне. Тогда каждая строка CSV соответствует одному элементу массива, а заголовки берутся из ключей.

Массив массивов (строки таблицы без имён колонок) тоже часто подходит: первая «внутренняя» строка может стать заголовком или просто порядком столбцов; смотрите, что ожидает ваш сценарий. Одиночный объект без массива даст одну строку данных; для списка всегда оборачивайте элементы в [ ].

Перед вставкой решите, нужен ли разделитель «;» для русского Excel. Запятая удобна для Google Таблиц и многих англоязычных программ. В Excel с русской локалью запятая часто воспринимается как десятичный разделитель, и столбцы слипаются в один.

Откуда брать исходник

Из DevTools: вкладка сети, тело ответа, копировать целиком. Из файла .json: откройте исходник, не скриншот терминала. Из почты или чата: проверьте, что не обрезали хвост массива.

Если строка приехала в Base64, сначала декодируйте. Если внутри «каша» без переносов и вы не уверены в скобках, сначала formatter, потом конвертация в CSV.

Частые ошибки подготовки

Вложили объект с вложенными адресами и ждали отдельные колонки city и street. Передали не массив, а объект-обёртку { "data": [ ... ] } и удивились, что в таблице одна колонка data. Скопировали только середину большого массива без внешних скобок.

В каждом случае сначала приведите текст к массиву объектов с плоскими полями. Потом вставляйте в конвертер. Глубокую вложенность Тулси в отдельные колонки автоматически не разворачивает: так устроен плоский CSV.

Как пройти путь в JSON в CSV на Тулси

Откройте JSON в CSV. Вставьте текст в поле или загрузите файл. Выберите разделитель: запятая или «;».

Инструмент соберёт колонки из полей объектов и строки из элементов массива. Скопируйте результат или скачайте файл .csv. Откройте его в Excel, LibreOffice или Google Таблицах и проверьте, что столбцы встали отдельно.

Если исходник невалидный, сначала почините его в JSON formatter. Если валидный, но таблица «кривая», вернитесь к форме данных: плоский массив, одинаковые ключи, без лишней обёртки.

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

Для Excel и многих российских учётных систем берите «;». Так столбцы обычно разделяются сразу, без мастера «Текст по столбцам». Для Google Таблиц и обмена с зарубежными сервисами чаще оставляют запятую.

Не смешивайте: если в тексте полей уже есть выбранный разделитель, значения должны быть в кавычках по правилам CSV. Конвертер обычно экранирует такие поля; всё равно гляньте глазами пару строк с адресами и длинными комментариями.

Копирование и скачивание

Копирование удобно для короткой таблицы: вставили в буфер, открыли лист, вставили. Скачивание файла удобнее для тысяч строк и передачи коллеге. Имя файла роли не играет; важнее кодировка UTF-8, которую даёт выгрузка из браузера.

Если после открытия в Excel кириллица превратилась в кракозябры, смотрите, как программа читает CSV. Прогоните файл через CSV в Excel: получите настоящий .xlsx с нормальными столбцами.

Как проверить результат и что делать при ошибке

Успех: в CSV есть строка заголовков, число строк совпадает с длиной массива (или близко к ней, если часть элементов отфильтровали), значения в нужных колонках. Откройте файл и отфильтруйте по одному полю, как в обычной таблице.

Неудача «не JSON»: вернитесь к исходнику, почините синтаксис formatter’ом, повторите. Неудача «одна колонка вместо пяти»: часто виноват разделитель или Excel открыл файл в неправильной локали. Смените «;» / «,» или соберите .xlsx через CSV в Excel.

Неудача «пустые или странные ячейки»: внутри лежали вложенные объекты. Выпрямите JSON вручную или в скрипте, оставьте на верхнем уровне только скаляры: строки, числа, булевы значения, null.

Данные на Тулси в этом инструменте не уходят на сервер: конвертация идёт на устройстве. Для ответов API с персональными полями это обычно приемлемый режим работы.

Смежные задачи рядом с таблицами

После CSV часто нужен нормальный Excel-файл без танцев с кодировкой. Для этого рядом лежит CSV в Excel. Обратный путь (таблица в массив для кода) закрывает CSV в JSON.

Если структура JSON сомнительна ещё до таблицы, сначала JSON formatter. Практика поиска ошибки: JSON formatter: как найти ошибку. Про открытие выгрузки в Excel без иероглифов: CSV в Excel без иероглифов.

Частые вопросы

Как преобразовать JSON в CSV?

Возьмите массив объектов с полями на верхнем уровне, вставьте его в JSON в CSV, выберите разделитель и скачайте файл. Каждый объект станет строкой, ключи станут заголовками колонок. Если текст невалидный, сначала почините его в JSON formatter. Для Excel в русской локали чаще ставьте «;».

Как конвертировать JSON в CSV без установки программ?

Откройте конвертер во вкладке браузера, вставьте JSON или загрузите файл, получите CSV. Регистрация для обычной выгрузки не нужна. Установка скрипта имеет смысл при ежедневном пайплайне; для разового ответа API хватает страницы на Тулси. Данные остаются на устройстве.

Есть ли JSON в CSV онлайн в браузере?

Да. На Тулси страница JSON в CSV как раз для этого: вставка, выбор разделителя, копирование или скачивание. Слово «онлайн» в поиске обычно значит «в браузере без установки». Убедитесь, что исходник это массив объектов или табличный массив массивов, а не произвольное дерево с глубокой вложенностью.

Какой JSON лучше всего подходит для таблицы?

Лучше всего массив объектов с одинаковыми ключами: [{ "id": 1, "title": "A" }, { "id": 2, "title": "B" }]. Подойдёт и массив строк таблицы (массив массивов). Объект-обёртка вокруг массива часто даёт одну колонку с «простынёй» внутри: достаньте массив на верхний уровень перед конвертацией.

Что делать со вложенными объектами?

Плоский CSV не умеет хранить дерево так же удобно, как JSON. Вынесите нужные поля наверх сами: вместо address.city сделайте ключ city. Если оставить вложенность как есть, в ячейке окажется нечитаемый фрагмент или поле пропадёт из удобных колонок. Для отчётов заранее готовьте плоский JSON.

Какой разделитель выбрать: запятую или точку с запятой?

Для русского Excel и многих выгрузок в 1С удобнее «;». Запятая чаще подходит Google Таблицам и международным инструментам. Если столбцы слиплись в один при открытии файла, смените разделитель и повторите выгрузку. Либо соберите .xlsx через CSV в Excel.

Данные уходят на сервер при конвертации?

Нет. На Тулси конвертация JSON в CSV выполняется в браузере на вашем устройстве. Это удобно для черновиков API и локальных логов. Если политика компании запрещает вставку любых данных во внешние страницы, используйте локальный скрипт в закрытом контуре.

Почему в Excel одна колонка вместо нескольких?

Частая причина: неверный разделитель относительно локали Excel. Вторая: файл открыли так, что программа не применила разбиение по столбцам. Третья: в исходнике был один ключ с длинной строкой вместо набора полей. Проверьте разделитель в JSON в CSV и при необходимости перегоните CSV в настоящий Excel-файл.

Чем JSON в CSV отличается от CSV в Excel?

JSON в CSV собирает табличный текст из структуры JSON. CSV в Excel берёт уже готовый CSV и делает книгу .xlsx, часто спасая кодировку и разделители. Если старт это ответ API в JSON, идите в JSON в CSV. Если старт это файл .csv с иероглифами, откройте CSV в Excel.

Нужен ли formatter перед конвертацией в CSV?

Если парсер сразу принимает текст, formatter не обязателен. Если видите ошибку разбора или не уверены в скобках, сначала разверните JSON и почините синтаксис. Formatter не заменяет конвертер: он чинит и читает структуру, а CSV нужен именно для таблицы. Оба шага часто идут подряд на одной выгрузке.

Если после CSV нужна книга Excel без сюрпризов с кодировкой, откройте CSV в Excel. Для поиска ошибки в исходнике подойдут JSON formatter и разбор в статье как найти ошибку в структуре.