Об этом инструменте
Этот конвертер JSON в CSV превращает массив объектов JSON, например ответ API или выгрузку из базы данных, в таблицу CSV, которая открывается в Excel, Google Таблицах или LibreOffice. Вложенные объекты разворачиваются в столбцы с путями через точку, массивы — в нумерованные столбцы, а столбцы всех записей объединяются в порядке их первого появления.
Вставьте JSON или откройте файл .json размером до 5 МБ, выберите разделитель и укажите, нужна ли строка заголовков, затем скопируйте CSV или скачайте его. Поля, содержащие разделитель, кавычки или переводы строк, заключаются в кавычки, как требует RFC 4180. Всё происходит в вашем браузере.
Как это работает
На вход можно подать массив объектов (одна строка на объект), массив массивов (одна строка на вложенный массив), массив простых значений (один столбец с именем value) или один объект (одна строка). Для некорректного JSON указываются строка и столбец ошибки, если браузер их сообщает.
Вложенные объекты превращаются в столбцы с путями через точку, например user.name и user.address.city. Массивы становятся нумерованными столбцами с индексами от нуля, такими как tags.0 и tags.1, поэтому сохраняется каждое значение, даже если у записей массивы разной длины. Пустые массивы и объекты, отсутствующие ключи и null становятся пустыми ячейками. Числа и логические значения записываются так же, как в JSON.
CSV использует окончания строк CRLF. Выберите точку с запятой, если ваш табличный редактор использует запятую как десятичный разделитель, и включите метку порядка байтов, если Excel неправильно показывает кириллицу или буквы с диакритикой.
Пример
Возьмём две записи с вложенным объектом user и массивом tags:
[{"id": 1, "user": {"name": "Ada", "email": "[email protected]"}, "tags": ["math", "code"]}, {"id": 2, "user": {"name": "Alan"}, "tags": ["logic"]}]
В CSV будут столбцы id, user.name, user.email, tags.0 и tags.1. Первая строка — 1,Ada,[email protected],math,code. Вторая строка — 2,Alan, затем пустой email, logic и пустая ячейка tags.1, потому что у записи Alan нет email и всего один тег.
Допущения и ограничения
Ввод ограничен 5 МБ текста; при объёме больше 300 000 символов результат обновляется только после нажатия кнопки «Преобразовать». JSON разбирается стандартным парсером браузера, поэтому целые числа больше 9 007 199 254 740 991 могут потерять точность, а у повторяющихся ключей остаётся только последнее значение. Массивы внутри массива массивов записываются в одну ячейку как текст JSON. Инструмент не защищает от формул табличных редакторов, поэтому значение, которое начинается с =, может быть вычислено при открытии файла в таблице. Данные не покидают ваш браузер.
Частые вопросы
Как преобразовать JSON в CSV для Excel?
Вставьте JSON или откройте файл, оставьте включённым параметр «Записать строку заголовков» и скачайте CSV. Если Excel неправильно показывает кириллицу, буквы с диакритикой или символы, включите метку порядка байтов. Если Excel помещает всё в один столбец, выберите разделитель «точка с запятой»: Excel ожидает его в региональных настройках с десятичной запятой, в том числе в русских.
Как обрабатываются вложенные объекты и массивы?
Каждое вложенное значение получает свой столбец. Ключи объектов соединяются точками, например address.city, а элементы массивов нумеруются с нуля, например items.0.sku и items.1.sku. Так сохраняются все значения и структуру можно потом восстановить, но очень длинные массивы дают много столбцов.
Что, если у записей разные ключи?
Конвертер собирает все ключи из всех записей. Столбцы идут в порядке их первого появления, а запись без какого-либо ключа получает пустую ячейку в этом столбце.
Мой JSON — объект, внутри которого массив data. Что делать?
Один объект становится одной строкой, поэтому ответ API вида {"data": [...]} превращается в столбцы data.0.id, data.1.id и так далее. Вставьте только массив, от открывающей [ до закрывающей ], чтобы получить по строке на каждую запись.
Почему некоторые значения заключены в кавычки?
CSV требует кавычек вокруг значений, которые содержат разделитель, двойную кавычку или перевод строки, а кавычки внутри таких значений удваиваются. Конвертер также заключает в кавычки значения с пробелами в начале или в конце, чтобы табличные редакторы эти пробелы сохранили.
Ссылка с вашими значениями
Добавьте эти параметры к адресу страницы, чтобы она открылась с уже заполненными значениями — например, чтобы поделиться расчётом или дать ссылку из ИИ-ассистента. Результат считается в браузере: в HTML страницы показан пример для значений по умолчанию, а когда значения из ссылки применены, инструмент ставит атрибут data-url-params.
| Параметр | Значение | Если не указан |
|---|---|---|
jsonИсходный JSON | не принимается в ссылках: введите на странице | |
delimiterРазделитель | одно из: comma, semicolon, tab, pipe | по умолчанию comma |
headerЗаписать строку заголовков | true или false | по умолчанию true |
byte_order_markДобавить метку порядка байтов (BOM), чтобы Excel правильно читал UTF-8 | true или false | по умолчанию false |
Примеры
?delimiter=semicolon&byte_order_mark=true?delimiter=tab&header=false
Дробную часть пишите через точку. Кодируйте пробел как %20, + как %2B, # как %23 и & как %26.
Элементы результата: [data-result-block="csv-json"]