Как быстро преобразовать CSV в JSON
Чтобы быстро превратить табличный список в структурированный JSON для сайта, каталога или базы данных, откройте конвертер CSV в JSON от Zyntec. Вставьте текст таблицы в поле ввода, укажите нужный разделитель и формат вывода: инструмент мгновенно обработает данные и подготовит чистый код без ошибок и ручной правки.
Подготовка данных перед конвертацией
Перед отправкой текста в сервис проверьте исходную структуру таблицы:
- Первая строка всегда отводится под заголовки. Именно эти названия станут ключами объектов в готовом JSON.
- Число полей в каждой строке должно строго совпадать с заголовком. Если в первой строке два столбца, то запись с тремя значениями вызовет ошибку ширины.
- Все значения на выходе остаются текстовыми строками. Числовые поля вроде цен, остатков или артикулов не конвертируются автоматически в числа и остаются в кавычках.
- В списке «Разделитель» доступны варианты «Авто», «Запятая», «Точка с запятой», «Табуляция» и «Вертикальная черта». Если структура данных понятна заранее, выберите конкретный символ вручную. Режим «Авто» выручает, когда разделитель нужно определить по содержимому текста.
- В поле «Формат JSON» можно выбрать «Массив объектов» или «Словарь по 1-му столбцу». Для словаря значения в первой колонке обязательно должны быть уникальными, так как они станут главными ключами записей.
- Размер исходного текста ограничен 200000 символов. Если ваш массив больше, разделите его на несколько частей и обработайте их по очереди.
Пошаговая инструкция
- Откройте онлайн-конвертер CSV в JSON на платформе Zyntec.
- Вставьте исходный текст в поле «CSV-данные». Убедитесь, что верхняя строка содержит названия колонок.
- Укажите подходящий вариант в поле «Разделитель» (например, «Запятая»).
- Выберите нужную структуру в поле «Формат JSON»: «Массив объектов» или «Словарь по 1-му столбцу».
- Запустите генерацию данных.
- Скопируйте готовый результат и проверьте соответствие ключей исходным колонкам.
Практические примеры с кодом
1. Формирование массива объектов
Этот формат удобен для вывода списков карточек товаров, новостных лент или каталогов. Исходный CSV:
name,price,qty
Чехол,590,12
Коврик,890,5
При выборе разделителя «Запятая» и структуры «Массив объектов» вы получите следующий результат:
[
{
"name": "Чехол",
"price": "590",
"qty": "12"
},
{
"name": "Коврик",
"price": "890",
"qty": "5"
}
]
2. Формирование словаря по первому столбцу
Такой вариант подходит для быстрого поиска элементов по их уникальному артикулу или ID. Исходный CSV:
sku,name,price
a1,Чехол,590
a2,Коврик,890
При выборе формата «Словарь по 1-му столбцу» структура превращается в объект с ключами «a1» и «a2»:
{
"a1": {
"name": "Чехол",
"price": "590"
},
"a2": {
"name": "Коврик",
"price": "890"
}
}
3. Автоматическое определение разделителя
Если внутри ячеек встречаются запятые, используйте точку с запятой как основной разделитель, а текстовые блоки оборачивайте в кавычки:
name;note
Чехол;"красный, синий, белый"
В режиме «Авто» запятые внутри кавычек останутся частью текстового значения поля «note».
Ограничения и нюансы форматов
- Заголовки должны располагаться строго в первой строке и разделяться тем же символом, что и весь документ. Пустые или некорректные имена колонок затруднят дальнейшую работу с кодом.
- Формат «Словарь по 1-му столбцу» корректно работает только при уникальных значениях в первой колонке. Если данные повторяются, они могут перезаписать друг друга.
- Выбирайте «Массив объектов», если порядок элементов важен и записи должны оставаться списком. Выбирайте «Словарь по 1-му столбцу», если первая колонка служит однозначным идентификатором.
- Всегда проверяйте готовую структуру перед загрузкой в проект, чтобы убедиться в правильном распознавании разделителей.
Частые ошибки и их решение
- Сообщение «Строка 2: ожидалось полей 2, получено 3» означает, что количество значений в строке не совпадает с заголовком. Проверьте лишние разделители в проблемной строке или оберните сложный текст в кавычки.
- Сообщение «Ошибка парсинга CSV» появляется при наличии незакрытых кавычек. Проверьте парность всех кавычек в исходном тексте.
- Сообщение «Выберите доступный формат JSON» напоминает о необходимости выбрать один из двух вариантов: «Массив объектов» или «Словарь по 1-му столбцу».
- При повторном запуске генератор формирует результат заново. Чтобы не потерять данные, сохраняйте итоговый сгенерированный текст сразу после конвертации.