В этой статье
JSON vs YAML: понимание форматов
JSON (JavaScript Object Notation) и YAML (YAML Ain't Markup Language) — это два самых популярных формата сериализации данных в современной разработке программного обеспечения. JSON является стандартом для веб-API и обмена данными в браузерах, тогда как YAML доминирует в конфигурационных файлах таких инструментов, как Kubernetes, Docker Compose, GitHub Actions и Ansible.
Хотя оба формата представляют одни и те же структуры данных (объекты, массивы, строки, числа), YAML заменяет фигурные и квадратные скобки JSON на структуру, основанную на отступах, что делает его более удобным для чтения сложных конфигураций.
Как работает конвертация JSON в YAML
Конвертация между JSON и YAML — это простой процесс, поскольку оба формата поддерживают одни и те же типы данных.
- JSON в YAML — конвертер анализирует JSON, затем сериализует результат в синтаксисе YAML с отступами вместо фигурных скобок
- YAML в JSON — конвертер анализирует YAML (учитывая отступы и специальные функции YAML, такие как якоря), затем выводит компактный JSON
- Оба направления сохраняют типы данных — строки, числа, булевы значения, null, массивы и вложенные объекты конвертируются без потерь
Попробуйте бесплатно — без регистрации
Конвертировать JSON / YAML →Когда использовать конвертер
Конвертер JSON в YAML полезен для разработчиков, работающих с инструментами, требующими разных форматов.
- Конфигурация Kubernetes — конвертируйте ответы JSON API в YAML-манифесты для kubectl apply
- Пайплайны CI/CD — преобразуйте данные JSON в YAML для конфигураций GitHub Actions, GitLab CI или CircleCI
- Тестирование API — конвертируйте тестовые фикстуры YAML в тела запросов JSON для Postman или curl
Часто задаваемые вопросы
Может ли YAML представить всё, что может JSON?
Да. YAML является надмножеством JSON — каждый действительный документ JSON также является действительным YAML. YAML дополнительно поддерживает комментарии, якоря/алиасы, многострочные строки и более выразительный синтаксис. Конвертация из JSON в YAML никогда не теряет данные.
А что насчёт функций YAML, которые JSON не поддерживает?
Некоторые функции YAML, такие как якоря, алиасы и пользовательские теги, не имеют эквивалента в JSON. При конвертации такого YAML в JSON якоря разворачиваются (вставляются встрочно), а пользовательские теги обычно удаляются. Результирующий JSON всё равно содержит полные данные, просто без метаданных, специфичных для YAML.
Является ли конвертация без потерь?
Для стандартных типов данных (строки, числа, булевы значения, null, массивы, объекты) конвертация полностью без потерь в обоих направлениях. Единственное отличие — форматирование: JSON использует фигурные и квадратные скобки, YAML использует отступы.