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 коротких урока на телефоне.





