Конвертация JSON в CSV за три шага
- Добавьте данные JSON. Вставьте объект или массив, или загрузите поддерживаемый файл
.json. - Выберите параметры преобразования. Настройте разворачивание, обработку массивов и один из доступных разделителей.
- Скачайте и проверьте CSV. Откройте файл в таблице или просмотрщике CSV перед использованием.
Примеры JSON в CSV
Массив объектов
Массив объектов — самый понятный источник для CSV, потому что каждый объект становится одной строкой.
[
{"id": 1, "name": "Ада"},
{"id": 2, "name": "Лин"}
]
Ключи становятся столбцами, а объекты — строками.
Одиночный объект
Одиночный плоский объект становится одной строкой CSV.
{
"results": [
{"id": 1, "status": "active"},
{"id": 2, "status": "paused"}
],
"count": 2
}
Объекты с разными ключами
Реальные массивы 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 при необходимости для совместимости с электронными таблицами
Частые проблемы при конвертации JSON в CSV
Вложенные поля отсутствуют
Включите разворачивание для столбцов на основе пути. Отключите его, чтобы сохранить вложенные объекты как текст JSON в ячейке.
В некоторых строках пустые ячейки
Объекты JSON содержат разные ключи или отсутствующие значения.
Массивы нечитаемы в Excel
Измените стратегию работы с массивами. Объединяйте примитивные значения для простых тегов или сохраняйте исходный массив как компактный JSON, когда структура важна.
Символы с диакритикой выглядят неправильно
Скачайте с настройками, совместимыми с UTF-8, и откройте файл с правильной кодировкой. Если есть опция BOM, она меняет только префикс байтов; она не перекодирует содержимое.
Часто задаваемые вопросы о JSON в CSV
Может ли этот конвертер обрабатывать вложенный JSON?
Да, для поведения разворачивания, реализованного на панели параметров. Ключи вложенных объектов могут стать столбцами на основе пути. Вложенные массивы требуют отдельной стратегии работы с массивами.
Как создаются заголовки CSV?
Конвертер строит заголовки из ключей, найденных в выбранных записях. Когда записи имеют разные ключи, объединение этих ключей становится полным набором заголовков.
Что происходит с массивами JSON?
Примитивные массивы можно объединить или сохранить как текст JSON. Массивы объектов сохраняются как JSON, а не объединяются в непригодный текст.
Сохраняются ли числа и логические значения?
Их текстовое представление записывается в CSV. Сам CSV не сохраняет типы JSON, поэтому дальнейшее программное обеспечение решает, как интерпретировать каждую ячейку.
Загружается ли JSON?
Да. Все входные данные для конвертации, включая вставленный текст, отправляются в API и хранилище SolConverter для обработки. Вставленный текст загружается без изменений как текст.
Можно ли конвертировать JSON обратно из CSV?
Да. Используйте конвертер CSV в JSON и выберите параметры заголовка и определения типов, соответствующие файлу.