Термин

YAML: читаемый формат конфигурации и данных

YAML — язык сериализации данных, часто применяемый для конфигурационных файлов.

Что означает термин#

В нём есть отображения, последовательности и скалярные значения. Отступы определяют структуру блочных коллекций, поэтому их изменение способно менять смысл файла. Удобство чтения не означает, что произвольный текст будет корректно разобран конкретной библиотекой.

Практический пример#

В конфигурации проекта список страниц расположен внутри ключа pages. Если изменить уровень отступа, элемент может оказаться на другом уровне или вызвать ошибку разбора. Значения, похожие на специальные типы, полезно записывать явно и проверять выбранным парсером.

Как проверить#

Разберите файл тем же инструментом и версией, которые используются при сборке. Проверьте полученную структуру, обязательные поля и типы, а не только отсутствие синтаксической ошибки. Не загружайте недоверенные конфигурации небезопасным способом. Валидный YAML ещё не доказывает, что приложение понимает его ключи и выполняет ожидаемые настройки.

Источники#

Проверены 23 октября 2026 г.. Официальные рекомендации отделены от наших примеров и результатов проверки.

Продолжить разбор