JSON, YAML и CSV хранят структурированные данные, но они не являются взаимозаменяемыми. Одна и та же запись о человеке выглядит аккуратно во всех трех случаях - до тех пор, пока вам не понадобятся вложенные адреса, введенные логические значения, комментарии в конфигурации или электронная таблица, которую ваш товарищ по команде может открыть в Excel. Выберите неправильный формат, и вы потеряете типы, превратите деревья в неудобные столбцы или столкнетесь с неожиданностью синтаксического анализатора, например, YAML, превращающим код страны NO в ложный. В этом руководстве сравниваются JSON, YAML и CSV, показывается, когда каждый из них выигрывает, и связываются бесплатные конвертеры на ToolsMinify.
Быстрый ответ
Используйте JSON для API и машинного обмена - строгий, достаточно типизированный и универсальный. Используйте YAML для конфигурации, редактируемой человеком, если вам нужны комментарии и привязки, а документы должны быть небольшими. Используйте CSV для плоских таблиц, которые люди открывают в электронных таблицах. Преобразуйте их с помощью Конвертера JSON в CSV и Конвертера YAML в JSON; аккуратные полезные данные с помощью JSON Minifier & Formatter.
Одна и та же запись во всех трех форматах
Начните с одного объекта: идентификатора, имени, активного флага и тегов. Вот как эта запись выглядит в каждом формате, чтобы вы могли сразу сравнить синтаксис.
JSON
- {"id": 42, "name": "Ada", "active": true, "tags": ["admin", "beta"]}
- Ключи в кавычках, запятые между полями, квадратные скобки для массивов, true/false/null в качестве литералов.
- Без комментариев. Завершающие запятые недопустимы в стандартном JSON.
ЯМЛ
- идентификатор: 42
- имя: Ада
- активен: правда
- теги:
- - администратор
- - бета
- Отступ определяет структуру. Кавычки часто необязательны. Комментарии начинаются с #.
CSV-файл
- идентификатор, имя, активный, теги
- 42,Ада,правда,"админ;бета"
- Одна строка заголовка, затем одна строка на запись. Вложенные массивы становятся плоской строкой или дополнительными столбцами. Никаких собственных типов, кроме текста.
Уже просматриваете массив объектов JSON? Вставьте его в Конвертер JSON в CSV, чтобы создать таблицу, удобную для работы с электронными таблицами. Переместить конфигурацию в другую сторону? Используйте Конвертер YAML в JSON перед клиентом API, который поддерживает только JSON.
JSON: API и обмен по умолчанию
JSON (нотация объектов JavaScript) - это подмножество синтаксиса объектов JavaScript, которое может анализировать каждый основной язык. Объекты, массивы, строки, числа, логические значения и значения NULL являются первоклассными. Вложенность не ограничена, поэтому объект адреса внутри объекта пользователя является естественным. Вот почему ответы REST и GraphQL, тела веб-перехватчиков и многие хранилища конфигураций отправляют JSON.
- Лучше всего подходит для: тел запросов и ответов API, браузерных и мобильных клиентов, очередей сообщений и всего, что должно проходить через множество языков.
- Сильные стороны: строгая грамматика, предсказуемые типы, отличный инструментарий, легко минимизировать и красиво печатать.
- Ограничения: никаких комментариев, никаких многострочных строк без экранирования, никаких привязок и слияний. Люди, редактирующие большой JSON вручную, получают шумные различия.
Когда полезная нагрузка поступает в виде одной сжатой строки, откройте JSON Minifier & Formatter, чтобы украсить ее, проверить фигурные скобки, а затем снова минимизировать перед отправкой.
YAML: люди конфигурации на самом деле редактируют
YAML (YAML не является языком разметки) в первую очередь предназначен для людей. Отступы заменяют большинство фигурных скобок. Вы можете оставлять комментарии с помощью #, писать многострочные блоки с помощью | или > и повторно используйте блоки с привязками (&name) и псевдонимами (*name). Эта комбинация сделала YAML стандартным для манифестов Kubernetes, Docker Compose, GitHub Actions и многих файлов конфигурации приложений.
Комментарии и якоря
Комментарии - это функция, которой не хватает JSON. Строка, начинающаяся с #, объясняет, почему тайм-аут составляет 30 секунд без изменения данных времени выполнения. Якоря идут дальше: определите общий блок журналирования один раз с помощью &logging, затем перенесите его в несколько сервисов с помощью *logging, при необходимости наложив ключи с помощью <<:. При осторожном использовании якоря исключают дублирование. При небрежном использовании они затрудняют чтение файлов и затрудняют их слияние в Git.
- Лучше всего подходит для: развертывания и конфигурации CI, флагов функций, которые редактируются людьми, небольших документов, читаемость которых важнее размера проводов.
- Сильные стороны: комментарии, привязки/псевдонимы, многострочные строки, меньше знаков препинания.
- Ограничения: ошибки отступов, неявные сюрпризы при вводе и большая поверхность атаки, если вы анализируете ненадежный YAML с помощью небезопасных загрузчиков.
CSV: плоские таблицы для электронных таблиц.
CSV (значения, разделенные запятыми) представляет собой сетку: столбцы и строки. Электронные таблицы, инструменты бизнес-аналитики и конвейеры данных это понимают. Здесь нет вложенного объекта, нет типа массива и обычно нет логического типа - все является текстом, пока ваш импортер не преобразует его. Это нормально, если ваши данные уже представляют собой таблицу пользователей или заказов. Он ломается, когда источником является дерево.
Почему CSV теряет типы и вложенность
- Типы: «42», 42 и true поступают в виде строк, если вы не определите схему. Ведущие нули в идентификаторах и номерах телефонов удаляются Excel.
- Вложенность: адрес с улицей и городом становится столбцом Address.street, большим двоичным объектом JSON в одной ячейке или дублированными родительскими строками.
- Массивы: теги часто представляют собой одну ячейку с разделителем (admin;beta), который необходимо разделить позже.
- Нуль против пустого: пустая ячейка может означать нулевое значение, пустую строку или отсутствующий столбец - соглашения различаются.
Если ваш источник представляет собой вложенный JSON, сознательно преобразуйте его с помощью Конвертера JSON в CSV и решите, как массивы и вложенные ключи должны выравниваться, прежде чем передавать файл в электронную таблицу.
Когда каждый формат - правильный выбор
API и межмашинное взаимодействие
Предпочитаю JSON. Клиенты ожидают применения application/json, инструменты есть повсюду, а система типов достаточно хороша для большинства контрактов. YAML как тело HTTP встречается редко и обычно является ошибкой. CSV в качестве ответа API имеет смысл только для конечных точек массового экспорта, которые используют Excel или хранилища данных.
Конфигурационные файлы
Предпочитайте YAML (или типизированный формат, такой как TOML), когда люди редактируют файл и нуждаются в комментариях. Предпочитайте JSON, когда конфигурация генерируется, проверяется схемой или редактируется в основном с помощью инструментов. Следите за тем, чтобы документы YAML были небольшими и тщательно проверялись - глубокие привязки и пользовательские теги плохо устаревают.
Таблицы и аналитика
Предпочитайте CSV (или настоящий формат электронных таблиц), если потребителем является Excel, Google Sheets или SQL COPY. Сначала сгладьте модель. Сохраняйте JSON для системы записи и экспортируйте CSV в качестве представления.
Эмпирическое правило
JSON для обмена, YAML для пользовательской конфигурации, CSV для табличного экспорта. Конвертируйте на границе - не заставляйте один формат выполнять все три задачи.
Классические ловушки
Проблема YAML в Норвегии
В YAML 1.1 несколько строк без кавычек анализируются как логические значения: да, нет, включено, выключено, истинно, ложно (и некоторые варианты локали). Код страны NO для Норвегии становится логическим значением false. Строки версии, такие как 1.10, могут стать числами с плавающей запятой. Цитируйте значения, которые выглядят как логические значения, числа или даты, хотя на самом деле они являются строками: страна: «НЕТ». По возможности отдавайте предпочтение синтаксическим анализаторам YAML 1.2 и при этом цитируйте подозрительные скаляры.
Запятые CSV внутри полей в кавычках
Поля, содержащие запятые, кавычки или символы новой строки, должны быть заключены в двойные кавычки. Кавычка внутри поля экранируется путем ее удвоения: "Ада ""Лавлейс""". Наивное разделение запятыми разрывает эти строки. Всегда используйте настоящий синтаксический анализатор или экспортер CSV, в том числе при использовании Конвертера JSON в CSV. Настройки локали также имеют значение: в некоторых регионах используются разделители точка с запятой, тогда как Excel по-прежнему ожидает запятые или наоборот.
Другие ошибки
- JSON: конечные запятые и комментарии из литералов объектов JavaScript не поддаются строгим синтаксическим анализам.
- YAML: табуляция против пробелов, небезопасные загрузчики, выполняющие теги, и огромные документы, скрывающие ошибки слияния.
- CSV: нет единого стандарта кодировки, разделителя или окончания строк; всегда документируйте UTF-8 и ваш разделитель.
Параллельное сравнение
- Вложенность - JSON и YAML: натуральные деревья. CSV: сгладить или потерять структуру.
- Типы - JSON: строка, число, bool, ноль, массив, объект. YAML: более богатые скаляры (плюс сюрпризы). CSV: текст до приведения.
- Комментарии - JSON: нет. YAML: # комментариев. CSV: нет стандартных комментариев.
- Человеческое редактирование - обычно побеждает YAML; JSON подходит для небольших файлов; CSV побеждает в электронных таблицах.
- Wire/API - по умолчанию используется JSON. YAML и CSV - крайние случаи.
- Инструменты - преобразование с помощью JSON в CSV и YAML в JSON; отформатируйте JSON с помощью JSON Minifier & Formatter.
Часто задаваемые вопросы
YAML лучше, чем JSON?
Для конфигурации, отредактированной человеком, с комментариями - часто да. Для API и обмена лучше подходит JSON: более строгий, более предсказуемый и универсально поддерживаемый. Многие команды создают YAML и компилируют или конвертируют его в JSON для выполнения.
Может ли CSV представлять вложенный JSON?
Только сглаживая. Вложенные объекты становятся столбцами с точками или строками JSON в ячейке; массивы становятся списками с разделителями или повторяющимися строками. Используйте CSV, когда потребителю нужна таблица, а не когда вам нужно сохранить все дерево.
Должен ли я хранить конфигурацию в формате JSON или YAML?
Если люди еженедельно редактируют его и оставляют комментарии, YAML (или TOML). Если файл принадлежит валидатору схемы или генератору кода, JSON. Избегайте смешивания обоих источников истины.
В чем проблема Норвегии в YAML?
NO без кавычек (и подобные токены) может анализироваться как логическое значение false в YAML 1.1. Цитируйте коды стран и другие строковые скаляры или используйте анализатор YAML 1.2, который обрабатывает их как строки.
Как мне конвертировать между этими форматами?
Используйте Конвертер YAML в JSON для формы конфигурации в API и Конвертер JSON в CSV для табличного экспорта. Украсьте или минимизируйте JSON с помощью JSON Minifier & Formatter. Все три запускаются в вашем браузере.
Конвертируйте JSON, YAML и CSV в ToolsMinify
Все приведенные ниже инструменты полностью работают в вашем браузере - бесплатно, без регистрации, ничего не загружается:
- Конвертер JSON в CSV - превратить массив объектов JSON в загружаемую таблицу CSV.
- Конвертер YAML в JSON - проанализировать конфигурацию YAML в JSON для API и валидаторов.
- JSON минимизатор и форматтер - красиво распечатайте или минимизируйте JSON и заранее выявите синтаксические ошибки.
- Все инструменты конвертера - полный индекс категорий.
Попробуйте бесплатно
Вставьте образец в Конвертер JSON в CSV или Конвертер YAML в JSON и сравните результат. Все остается на вашем устройстве.