Конвертер JSON в CSV нужен, когда данные из API, выгрузки или ручного JSON-массива нужно быстро привести к табличному виду. Эта страница помогает конвертировать JSON в CSV прямо в браузере без отправки данных на сервер.
Какой результат получится
Для массива объектов конвертер собирает общий список колонок по ключам объектов и добавляет строку заголовков. Если в разных объектах встречаются разные ключи, они попадают в общий набор колонок, а отсутствующие значения остаются пустыми.
Для массива массивов CSV строится без автоматической строки заголовков: каждая вложенная строка JSON становится строкой CSV. Такой вариант удобен, если заголовки уже не нужны или структура данных заранее задана позициями.
Как работает JSON → CSV
Поддерживаются два входных формата:
- Массив объектов.
- Массив массивов.
Пример массива объектов: первая запись содержит поля name, age и city со значениями Alice, 30 и Moscow; вторая запись содержит Bob, 28 и Berlin. CSV-вывод в таком случае получает строку заголовков name, age, city и две строки данных с соответствующими значениями.
Вложенные объекты и массивы внутри ячеек сохраняются как JSON-строка внутри CSV-поля. Если такая строка содержит кавычки, разделитель или перенос строки, поле экранируется кавычками по правилам CSV.
Разделители и кавычки
Для итогового CSV можно выбрать запятую, точку с запятой, табуляцию или вертикальную черту. В режиме JSON в CSV авто-режим использует обычную запятую.
Конвертер экранирует значения, где есть выбранный разделитель, кавычки, переносы строк или пробелы по краям. В обратном режиме CSV в JSON он также сообщает об ошибках вроде кавычки внутри некавыченного поля или незакрытой кавычки.
Ограничения
- В режиме JSON в CSV поддерживаются только массив объектов и массив массивов.
- Если массив объектов не содержит ни одного ключа, CSV собрать нельзя.
- Инструмент работает с текстом в поле ввода, а не с загрузкой файлов.
- Кнопка скачивания файла не входит в текущий scope страницы; результат можно скопировать как текст.
- Вложенные структуры не разворачиваются в dot-notation колонки: они сохраняются одной JSON-строкой в CSV-ячейке.
Частые сценарии
- Подготовить JSON-массив объектов к открытию в электронной таблице.
- Проверить, какие колонки будут сформированы из ключей объектов.
- Получить CSV с нужным разделителем для импорта в другую систему.
- Быстро увидеть ошибку, если вход не является JSON-массивом или не содержит ключей для заголовков.