JSON в YAML на Python
Готовый код на Python для обоих направлений и параметры, которые сохраняют вывод корректным.
JSONввод
YAMLвывод
Каждая строка результата в стандартном форматировании рядом с путём к значению, которое она содержит. Нажмите на строку, чтобы скопировать путь.
Работает полностью в вашем браузере: ничего не загружается на сервер. Действуют ограничения добросовестного использования (5 MB на ввод, лимит частоты конвертаций) для защиты от спама и ботов.
JSON в YAML и обратно с PyYAML
PyYAML вместе со стандартным модулем json покрывает оба направления. Эти параметры дают самый чистый вывод.
import json
import yaml # pip install pyyaml
with open("data.json", encoding="utf-8") as f:
data = json.load(f)
with open("data.yaml", "w", encoding="utf-8") as f:
yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True) import json
import yaml # pip install pyyaml
with open("data.yaml", encoding="utf-8") as f:
data = yaml.safe_load(f)
with open("data.json", "w", encoding="utf-8") as f:
# default=str turns dates and datetimes into strings
json.dump(data, f, indent=2, ensure_ascii=False, default=str) Многодокументный YAML и YAML 1.2
Читайте все документы файла в стиле Kubernetes с помощью safe_load_all или используйте ruamel.yaml для правил YAML 1.2 и точных отступов.
import json
import yaml
with open("manifests.yaml", encoding="utf-8") as f:
docs = list(yaml.safe_load_all(f)) # one item per --- document
print(json.dumps(docs, indent=2, default=str)) import json
import sys
from ruamel.yaml import YAML # pip install ruamel.yaml
yaml = YAML() # round-trip mode, YAML 1.2
yaml.indent(mapping=2, sequence=4, offset=2)
with open("data.json", encoding="utf-8") as f:
yaml.dump(json.load(f), sys.stdout) Однострочники на Python
Удобны в shell-скриптах и CI, если установлен PyYAML.
# JSON to YAML
python3 -c 'import sys, json, yaml; yaml.safe_dump(json.load(sys.stdin), sys.stdout, sort_keys=False, allow_unicode=True)' < data.json > data.yaml
# YAML to JSON
python3 -c 'import sys, json, yaml; json.dump(yaml.safe_load(sys.stdin), sys.stdout, indent=2, default=str)' < data.yaml > data.json Частые проблемы и их решения
Сюрпризы, с которыми чаще всего сталкиваются при конвертации с PyYAML. Выберите один, чтобы увидеть его до и после исправления.
| Симптом | Причина | Решение |
|---|---|---|
| Ключи оказываются отсортированы | safe_dump по умолчанию сортирует ключи. | Передайте sort_keys=False. |
| é превращается в "\xE9" | Не-ASCII символы по умолчанию экранируются. | Передайте allow_unicode=True. |
| yes / no / on / off | PyYAML следует YAML 1.1, поэтому no без кавычек загружается как False. | Заключите их в кавычки в YAML или используйте ruamel.yaml (YAML 1.2). |
| TypeError: datetime is not JSON serializable | safe_load превращает 2026-10-01 в объект date. | Передайте default=str в json.dump. |
| load() без Loader | PyYAML 6 требует Loader для yaml.load. | Используйте yaml.safe_load, который никогда не выполняет код из файла. |
| Только первый документ | safe_load читает один документ. | Используйте safe_load_all для файлов, разделённых ---. |
Другие инструменты
Конвертеры, валидаторы и пошаговые руководства для всех мест, где встречаются JSON и YAML.
Конвертеры
Форматирование и проверка
Конвертация по задачам
- Kubernetes Превращайте JSON-вывод kubectl и объекты API в чистые манифесты, готовые к применению.
- Docker Compose Собирайте compose.yaml из JSON, включая порты, окружение и тома.
- GitHub Actions Пишите файлы рабочих процессов из JSON без ловушки on: / true.
- OpenAPI / Swagger Конвертируйте спецификации OpenAPI 3 и Swagger 2.0 между JSON и YAML.
- CloudFormation Конвертируйте шаблоны AWS CloudFormation из JSON в YAML вместе со встроенными функциями.
Руководства по коду и командной строке
Частые вопросы
Как конвертировать JSON в YAML на Python?
Загрузите JSON с помощью json.load и запишите его через yaml.safe_dump из PyYAML: yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True). Эти два параметра сохраняют порядок ключей и не-ASCII символы как есть.
Как конвертировать YAML в JSON на Python?
Прочитайте файл с помощью yaml.safe_load и запишите его через json.dump(data, f, indent=2, default=str). Используйте yaml.safe_load_all, если в файле несколько документов, разделённых ---.
Что выбрать: PyYAML или ruamel.yaml?
PyYAML является самым распространённым выбором, и его достаточно для разовых конвертаций. ruamel.yaml реализует YAML 1.2, сохраняет комментарии и порядок ключей при редактировании существующего YAML и даёт более тонкий контроль над отступами.
Почему safe_load, а не load?
yaml.load с полным загрузчиком может создавать произвольные объекты Python по тегам из файла, что небезопасно для недоверенного ввода. safe_load строит только простые типы: словари, списки, строки, числа, логические значения, None и даты.
Можно ли конвертировать, ничего не устанавливая?
Да. Конвертер в начале этой страницы работает в браузере и не требует Python, пакетов или загрузки на сервер. Вставьте JSON или YAML и скопируйте результат.