Что такое…

CSV или JSON — что выбрать для своих данных

Иллюстрация: длинная плоская лента ячеек рядом с ящиками, вложенными друг в друга

Держи неожиданное: CSV — это не таблица. Это обычный текстовый файл, где значения разделены запятыми, а «таблицу» из него рисует уже программа. Отсюда все его беды: одна запятая внутри названия товара — и строка разъезжается. Разберёмся, когда брать CSV, когда JSON, и на чём горят оба.

Коротко: в чём вообще разница

CSV — плоский список строк. Первая строка обычно заголовки, дальше — данные, по одной записи на строку. Всё:

name,city,age
Аня,Москва,29
Пётр,Казань,34

JSON — вложенная структура. У значения может быть свой объект внутри, у него — массив, и так на любую глубину:

[
  { "name": "Аня", "city": "Москва", "skills": ["дизайн", "фото"] },
  { "name": "Пётр", "city": "Казань", "skills": [] }
]

Вот и весь водораздел: CSV плоский, JSON вложенный. Попробуй запихнуть список навыков в CSV — придётся склеивать их в одну ячейку через какой-нибудь разделитель и потом разбирать обратно. Это уже костыль.

Сравнение по тому, что важно новичку

  • Вложенность. JSON держит структуру любой глубины. CSV — только прямоугольник строк и колонок. Если данные похожи на дерево, CSV сразу отпадает.
  • Типы значений. В JSON есть числа, строки, true/false, null и они различимы. В CSV всё — текст: 007 может превратиться в 7, а 1,5 вообще расколоться на две ячейки.
  • Размер и скорость. CSV заметно компактнее: имена колонок написаны один раз сверху, а в JSON ключ повторяется в каждой записи. На миллионе строк разница ощутима.
  • Читаемость человеком. CSV открывается в любой таблице и понятен кому угодно. JSON понятен разработчику.
  • Устойчивость к обрыву. Испорченная строка CSV портит одну строку. Одна пропущенная скобка в JSON делает нечитаемым весь файл — программа не разберёт его целиком.
  • Кому отдавать. Бухгалтеру, маркетологу, в Excel — CSV. Другой программе, в API, в конфиг — JSON.

Кому что подойдёт

Без виляний:

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

Бери JSON, если у данных есть структура или их читает программа. Ответ API, настройки приложения, объект с вложенными списками, что угодно между фронтендом и базой данных. Тут CSV начнёт рассыпаться на первом же вложенном поле.

Правило одной фразой: человеку и плоское — CSV, программе и вложенное — JSON.

Два подвоха, о которых не пишут

Первый: запятая внутри значения. Название «Кофе, молотый» превратит одну ячейку в две, и вся строка съедет. Правильный CSV решает это кавычками — значение с запятой берётся в двойные кавычки, а сама кавычка внутри удваивается:

name,price
"Кофе, молотый",890
"Чай ""Эрл Грей""",450

Отсюда вывод: не собирай CSV склейкой строк через запятую руками. Возьми готовую библиотеку — она знает про экранирование. Собственный «простой» генератор CSV ломается ровно в тот день, когда в данных появляется первая запятая.

Второй: Excel и кириллица. Ты выгружаешь файл в UTF-8, открываешь в Excel — и вместо «Москва» видишь кракозябры. Excel на Windows не определяет кодировку сам: ему нужен маркер в начале файла (BOM) либо импорт через мастер с явным указанием UTF-8. Плюс в русской локали Excel ждёт разделителем точку с запятой, а не запятую — потому что запятая занята под десятичную дробь. Так что «файл битый» тут обычно означает «файл нормальный, Excel просто не спросил».

Можно ли конвертировать одно в другое?

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

Почему выгрузка открывается кракозябрами?

Потому что файл в UTF-8, а программа читает его как другую кодировку. Быстрое лечение: открыть в Google Таблицах (они определяют сами) или импортировать в Excel через «Данные — Получить данные из текстового файла», выбрав UTF-8. Если файл генерируешь ты — добавь BOM в начало.

А есть что-то среднее между ними?

Есть, и оно решает главную боль JSON на больших выгрузках — формат JSONL: по одному JSON-объекту на строку, без общего массива и запятых между записями.

{"name": "Аня", "skills": ["дизайн"]}
{"name": "Пётр", "skills": []}

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

А чем JSON лучше YAML для данных?

Разными задачами: JSON — обмен между программами, YAML — конфиги, которые правят руками. Подробнее разобрали в отдельном сравнении JSON и YAML. Для выгрузки данных YAML почти никогда не выбирают: он громоздкий и чувствителен к отступам.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →