Преобразовать JSON в CSV JavaScript Object Notation ↔ Comma-Separated Values Бесплатно Онлайн Безопасно

Почему люди конвертируют JSON в CSV

JSON — язык, на котором программы разговаривают друг с другом. Выгрузка из веб-сервиса, ответ API, конфигурация, сохранённая приложением, дамп из базы данных: большая часть приходит в виде JSON. Он прекрасен для программ и неудобен для людей, потому что экран, заполненный скобками, кавычками и запятыми, нельзя отсортировать, отфильтровать или сложить. CSV — противоположность: простая таблица, одна строка на линию, ячейки разделены запятыми, которую открывает каждая электронная таблица на свете. Поэтому люди и конвертируют JSON в CSV: у них есть данные, созданные программой, и они хотят посмотреть на них, подсчитать их или передать тому, кто живёт в электронной таблице.

Ситуации знакомые. Аналитик, достающий записи из API и желающий сводную таблицу. Владелец магазина, выгрузивший заказы с онлайн-платформы и нуждающийся в них в Excel. Исследователь с результатами опроса, сохранёнными инструментом. Разработчик, желающий окинуть взглядом несколько сотен записей. Во всех случаях данные уже структурированы, а не хватает лишь таблицы.

Эта страница конвертирует JSON в CSV в вашем браузере. Ваш файл читается и записывается здесь, поэтому он никогда не покидает ваше устройство, что важно для списков клиентов, заказов и всего прочего личного. И страница заранее сообщает, что при переходе сохраняется, а что нет, вместо того чтобы оставлять вас открывать это самим. Ниже вы найдёте, как работает конвертация, какой вид JSON может стать таблицей и что происходит с остальным.

Как работает конвертация

Ключи становятся заголовком в порядке первого появления

Ваш файл JSON считывается внутри браузера. Ключи записей становятся строкой заголовка CSV в порядке их первого появления. Каждая запись затем становится строкой, а каждое значение записывается как есть. Если посмотреть на первую строку результата, вы увидите названия полей; под ними — по одной строке на каждую запись.

Отсутствующий ключ оставляет пустую ячейку

Записи не всегда однородны. В одной может не хватать поля, которое есть у остальных. В таком случае строка без ключа оставляет пустую ячейку, а не сдвигает столбцы. Столбец остаётся на своём месте, а ячейка просто пуста, так что таблица остаётся выровненной.

Каждая строка и каждый столбец

Ничего не отбрасывается. Каждая запись становится строкой, а каждый ключ, появляющийся где-либо, становится столбцом. Вам не нужно беспокоиться, что поле, встречающееся лишь в тысячной записи, будет пропущено.

Что сохраняется

Все строки и все столбцы

Сохраняются каждая строка и каждый столбец. Данные, которые вы дали, — это данные, которые вы получаете, в табличной форме.

Значения как есть

Каждое значение записывается как есть. Числа остаются числами, текст — текстом, а значения, содержащие запятые или кавычки, правильно заключаются в кавычки, чтобы электронная таблица читала их как одну ячейку.

Порядок полей

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

Что нужно знать, прежде чем конвертировать JSON в CSV

Только одна форма JSON уже является таблицей

Только одна форма JSON уже является таблицей: массив плоских объектов, например список записей, у каждой из которых одинаковый набор полей. Одиночный объект или дерево с объектами внутри объектов не имеет строк для записи и отклоняется, а не сплющивается во что-то, о чём вы не просили. Это сознательный выбор. Сплющивание дерева включает решения об именах и о том, какие ветви сохранить, а неверная догадка дала бы таблицу, которая выглядит правильно, но не является таковой.

Вложенные значения записываются как текст JSON

Там, где само значение — список или объект, оно записывается в ячейку как текст JSON, потому что ячейка не может вместить ветвь. Так, запись с полем для тегов, содержащим список, покажет этот список текстом в одной ячейке. Всё это там, и вы можете разделить его инструментами вашей электронной таблицы, если пожелаете.

В CSV нет типов

Файл CSV — это текст. Будет ли 007 числом или кодом, решает электронная таблица при открытии файла, а электронные таблицы известны тем, что угадывают неверно. Ведущие нули, длинные числа и даты могут измениться при открытии. Если это важно, импортируйте файл через диалог импорта и пометьте такие столбцы как текст.

Как конвертировать JSON в CSV здесь

Добавьте файл

Перетащите файл JSON на страницу или выберите его на устройстве. Он считывается внутри вашего браузера и не загружается.

Конвертируйте

Нажмите кнопку. Файл обычного размера занимает мгновение. Оставляйте страницу открытой, пока всё не завершится.

Скачайте и откройте

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

Подробнее о JSON и CSV

Деревья и таблицы

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

Почему строгость помогает

Инструменты, принимающие любой JSON и автоматически его сплющивающие, часто придумывают названия столбцов вроде address.street или items.0.price. Это удобно, пока вам не нужно знать, что произошло. Принимая только форму, которая уже является таблицей, эта страница избавляет вас от молчаливых решений. Если ваш файл — дерево, вы узнаёте это сразу.

Запятые, кавычки и переносы строк

У CSV свои ловушки: запятая внутри значения, кавычка, перенос строки посреди ячейки. Они обрабатываются заключением ячейки в кавычки и удвоением кавычек внутри неё, так что электронная таблица читает таблицу так, как задумано.

Типичные ситуации подробно

Выгрузки из веб-сервисов и API

Большинство сервисов возвращает списки записей в виде JSON. Если они нужны вам в электронной таблице, конвертируйте JSON в CSV и откройте результат. Это быстрейший путь от ответа API к сводной таблице.

Заказы, клиенты и товары

Платформы магазинов часто позволяют выгружать данные как JSON. CSV с заказами или товарами можно отсортировать по дате, отфильтровать по клиенту или просуммировать по товару в несколько щелчков.

Результаты опросов и журналы

Инструменты, хранящие ответы опросов или журналы событий как JSON, дают по одной записи на ответ или событие. В виде CSV их можно подсчитывать, строить по ним диаграммы и сравнивать.

Проверка данных с одного взгляда

Разработчики часто конвертируют несколько сотен записей в CSV просто чтобы их прочитать. Таблицу проще просматривать, чем вложенные скобки, а электронная таблица может сортировать и выделять выбивающиеся записи.

Практические советы перед тем, как конвертировать JSON в CSV

Проверьте форму вашего файла

Откройте JSON в текстовом редакторе. Если он начинается с квадратной скобки и содержит список записей в фигурных скобках с простыми значениями, это правильная форма. Если он начинается с фигурной скобки и внутри вложены записи, найдите нужный вам список и сначала извлеките его.

Знайте, какие значения вложены

Если некоторые поля содержат списки или объекты, они появятся в своих ячейках как текст JSON. Решите, нужно ли вам их разделять, и запланируйте сделать это в электронной таблице.

Следите за кодировкой и разделителем

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

Большие файлы

Всё выполняется на вашем устройстве, поэтому очень большому файлу нужна память. Для файлов в много мегабайт используйте компьютер и разделите данные, если страница не справляется.

Вопросы, которые задают перед конвертацией

Почему мой файл отклонён?

Потому что это не массив плоских объектов. Одиночный объект или дерево с объектами внутри объектов не имеет строк для записи. Выберите нужный вам список и конвертируйте его.

Что происходит с записью, в которой нет поля?

Она оставляет пустую ячейку в этом столбце. Столбцы не сдвигаются.

Что происходит со списками внутри записи?

Они записываются в ячейку как текст JSON, потому что ячейка не может вместить ветвь.

Почему мои ведущие нули исчезают в электронной таблице?

Потому что электронная таблица решила, что столбец числовой, когда открыла файл. CSV хранит нули; используйте диалог импорта и пометьте столбец как текст.

Загружается ли мой файл?

Нет. Конвертация выполняется в вашем браузере, и файл никогда не покидает ваше устройство.

Можно ли вернуться к JSON?

Да. CSV в JSON превращает таблицу обратно в список записей.

Разумный выбор при конвертации JSON в CSV

CSV или настоящая электронная таблица?

Если вам нужен файл, открывающийся в Excel с настоящим листом, JSON в XLSX записывает ту же таблицу как книгу. CSV легче и универсальнее; XLSX открывается без шага импорта.

Другие цели

Если назначение — конфигурация или файл разметки, этим нуждам служат JSON в XML и JSON в YAML.

Сохраните JSON

JSON — это мастер. Он хранит структуру и типы. Сохраните его и относитесь к CSV как к представлению данных.

Как добиться хорошего результата после конвертации

Импортируйте, а не просто открывайте

Когда файл содержит коды, телефонные номера или даты, используйте диалог импорта вашей электронной таблицы и задайте тип каждого столбца. Это избавляет от тихого ущерба, который может причинить автоматическое угадывание.

Сверьте несколько строк с источником

Сравните пару записей в таблице с JSON. Это занимает минуту и говорит, что таблица верна.

При необходимости разделите вложенные ячейки

Если ячейка содержит список как текст, используйте инструмент «текст по столбцам» или формулу, чтобы разделить его. Или вернитесь и подготовьте JSON так, чтобы у каждого элемента была своя запись.

Подготовка JSON для хорошей конвертации

Придайте данным форму, прежде чем конвертировать JSON в CSV

Если ваш файл — дерево, вы обычно можете преобразовать его в список плоских записей, прежде чем конвертировать JSON в CSV. Выберите список, содержащий то, что вы хотите подсчитать: заказы, клиентов, события. Скопируйте его в отдельный файл, с квадратными скобками вокруг, и страница его примет. Этот маленький шаг — разница между отказом и чистой таблицей.

Давайте полям осмысленные имена

Ключи становятся заголовком, поэтому чем яснее имена, тем читабельнее таблица. Если вы контролируете источник, используйте имена вроде order_date и customer_name вместо сокращений, понятных только программисту.

Будьте последовательны в типах

Поле, содержащее числа в большинстве записей и текст в нескольких, запутает электронную таблицу. Если можете, очистите нетипичные до конвертации, чтобы каждый столбец означал одно.

Подумайте о датах

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

Сначала проверьте на небольшом фрагменте

Если ваш файл велик, скопируйте первые двадцать записей в тестовый файл и конвертируйте его. Быстрый взгляд на результат показывает, соответствуют ли форма и имена полей ожидаемому, прежде чем тратить время на всё целиком.

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

Почему локальная конвертация важна для данных

Файлы данных часто содержат личное: клиентов, заказы, адреса, сообщения. Многие онлайн-конвертеры загружают ваш файл на сервер, обрабатывают его и присылают результат, и некоторое время копия живёт на машине, которую вы не контролируете. Здесь работу выполняет ваш собственный браузер, поэтому данные остаются на вашем устройстве.

Что происходит, когда вы уходите

Когда вы закрываете страницу, конвертированный файл исчезает из браузера, поэтому сначала скачайте его. Ничего о ваших данных не сохраняется.

Если что-то пошло не так

Страница говорит, что файл не является корректным JSON

Возможно, есть лишняя запятая, пропущенная кавычка или не закрывающаяся скобка. Откройте файл в редакторе, подсвечивающем ошибки JSON, и исправьте строку, на которую он указывает.

Столбцы выглядят перепутанными

Ваша электронная таблица, возможно, ожидает другого разделителя. Импортируйте файл и задайте разделитель — запятую.

Страница зависает с большим файлом

Всё выполняется на вашем устройстве, а большому файлу нужна память. Попробуйте снова на компьютере или разделите данные.

Связанные инструменты

То же семейство инструментов охватывает соседние задачи. Чтобы вернуться, используйте CSV в JSON. Для книги JSON в XLSX и XLSX в JSON работают с файлами Excel. Для других форматов структурированных данных есть JSON в XML, XML в JSON, JSON в YAML и YAML в JSON. Когда цифры в PDF, PDF в XLS восстанавливает таблицу со страницы.

Разобранный пример

Допустим, вы выгрузили 500 заказов из интернет-магазина как файл JSON и хотите узнать, какие товары продаются лучше всего. Вы перетаскиваете файл сюда и нажимаете кнопку. Через мгновение вы скачиваете CSV с заголовком из названий полей и 500 строками под ним. Вы импортируете его в электронную таблицу, помечаете код товара как текст, делаете сводную таблицу и видите ответ. JSON остаётся в вашей папке как источник.

Краткий чек-лист

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

Проверьте, что файл — список записей. Отметьте, какие поля вложены. Сохраните JSON.

Во время конвертации

Оставайтесь на странице, пока файл не будет готов.

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

Импортируйте CSV с правильными типами, сверьте несколько строк с источником и сохраните таблицу в формате вашей электронной таблицы.

Типичные ошибки

Подача дерева

Не ожидайте, что получится конвертировать JSON в CSV для глубоко вложенного файла. Сначала извлеките список записей.

Открытие двойным щелчком и доверие результату

Электронные таблицы угадывают типы. Импортируйте с явными типами для кодов и дат.

Удаление JSON

Сохраните его. Он хранит структуру, которой нет у таблицы.

Ваши данные остаются на вашем устройстве

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

Итог

Чтобы конвертировать JSON в CSV здесь, перетащите файл и нажмите кнопку. Он считывается и записывается в вашем браузере, поэтому файл никогда не покидает ваше устройство. Сохраняются каждая строка и каждый столбец: ключи становятся заголовком в порядке первого появления, а каждое значение записывается как есть. Строка без ключа оставляет пустую ячейку, а не сдвигает столбцы. Только одна форма JSON уже является таблицей — массив плоских объектов. Одиночный объект или дерево с объектами внутри объектов не имеет строк для записи и отклоняется, а не сплющивается во что-то, о чём вы не просили. Там, где само значение — список или объект, оно записывается в ячейку как текст JSON, потому что ячейка не может вместить ветвь.