Как быстро перевести CSV в JSON

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

Подготовка исходных данных

Первая строка таблицы обязательно должна содержать заголовки: именно они превратятся в ключи объектов внутри JSON. Инструмент сохраняет все исходные значения как строки, поэтому числовые параметры вроде цен, скидок или складских остатков не приводятся к числовому типу автоматически.

Перед отправкой текста на обработку обратите внимание на следующие нюансы:

  • Одинаковое число полей. В каждой строке должно быть ровно столько же элементов, сколько в заголовке. Лишний разделитель в описании товара сместит соседние колонки и нарушит структуру.
  • Кавычки для сложных значений. Если внутри ячейки встречаются запятые, точки с запятой или перечисления параметров, обязательно заключите весь фрагмент в двойные кавычки.
  • Уникальность идентификаторов. Если вы планируете формировать «Словарь по 1-му столбцу», проследите, чтобы в первой колонке находились уникальные значения (например, артикулы или системные ID). Именно они станут корневыми ключами объекта.
  • Лимит по объему. Сервис принимает фрагменты размером до 200 000 символов. Если ваша выгрузка превышает этот объем, разделите ее на несколько частей и конвертируйте по очереди.

Пошаговый процесс конвертации

  1. Откройте инструмент. Перейдите к конвертеру на сайте Zyntec и найдите поле «CSV-данные».
  2. Вставьте таблицу. Добавьте скопированные строки вместе с шапкой таблицы в поле ввода.
  3. Укажите разделитель. Выберите подходящий символ в списке «Разделитель» или воспользуйтесь автоматическим определением.
  4. Выберите итоговую структуру. В поле «Формат JSON» отметьте «Массив объектов» или «Словарь по 1-му столбцу».
  5. Запустите обработку. Отправьте подготовленный текст на конвертацию.
  6. Оцените результат. Скопируйте готовый JSON и проверьте соответствие полей исходной таблице перед интеграцией в проект.

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

1. Формирование массива объектов

Классический вариант для каталогов, списков статей и карточек товаров. Исходные данные с разделителем-запятой:

name,price,qty
Чехол,590,12
Коврик,890,5

При выборе формата «Массив объектов» и разделителя «Запятая» на выходе получается список однотипных сущностей:

[
  {
    "name": "Чехол",
    "price": "590",
    "qty": "12"
  },
  {
    "name": "Коврик",
    "price": "890",
    "qty": "5"
  }
]

Каждая строка стала отдельным объектом с тремя строковыми полями.

2. Автоматическое определение разделителя и кавычки

Если внутри ячейки содержится текст со знаками препинания, используйте кавычки:

name;note
Чехол;"красный, синий, белый"

При выборе режима «Авто» разделителем признается точка с запятой, а список цветов внутри кавычек остается единым значением в поле note.

3. Словарь по первой колонке

Удобный формат для быстрой выборки сущностей по их уникальному ключу (артикулу или коду):

sku,name,price
a1,Чехол,590
a2,Коврик,890

При выборе формата «Словарь по 1-му столбцу» первой колонке присваивается роль ключа верхнего уровня:

{
  "a1": {
    "name": "Чехол",
    "price": "590"
  },
  "a2": {
    "name": "Коврик",
    "price": "890"
  }
}

Ограничения инструмента и особенности формата

  • Два режима на выбор. Конвертер формирует либо плоский список объектов («Массив объектов»), либо ассоциативный массив («Словарь по 1-му столбцу»). Выбирайте формат под требования вашего API или фронтенда.
  • Строковый тип данных. Все числа, даты и булевы флаги сохраняются строками. Если для работы базы данных или скриптов требуются строгие типы данных, обработайте типы на этапе парсинга в коде.
  • Требование к уникальности ключей в словаре. Если в первой колонке есть дублирующиеся значения, словарь перезапишет одноименные ключи. Для таких данных выбирайте «Массив объектов».
  • Чувствительность к синтаксису. Инструмент не сможет обработать файл, если в нем нарушена парность кавычек, сбито число колонок в строках или превышен лимит в 200 000 символов.

Частые ошибки и способы их решения

  • Несовпадение количества колонок. Если в какой-то строке значений больше или меньше, чем колонок в шапке, конвертер выдаст системное предупреждение с указанием места сбоя. Например: «Строка 2: ожидалось полей 2, получено 3». В этом случае проверьте строку на случайные разделители и оберните текстовые поля в кавычки.
  • Некорректный выбор формата. При отсутствии выбранного типа вывода система отобразит подсказку «Выберите доступный формат JSON».
  • Ошибки синтаксиса и незакрытые кавычки. Если кавычка открыта, но не закрыта до конца строки или файла, появится уведомление «Ошибка парсинга CSV» с уточнением «unexpected end of data». Проверьте целостность текстовых блоков в исходной таблице.
  • Проблемы с разделителем. Если структура итогового файла выглядит сплошной строкой, проверьте, совпадает ли выбранный разделитель с реальным символом в тексте. Для нестандартных выгрузок протестируйте автоматический режим на небольшом фрагменте данных.

Читайте также