YAML

JSON удобен для машин и немного враждебен к людям. YAML — это та же информация, переписанная так, чтобы человек мог спокойно набрать ее руками.

Возьми ровно те же данные с карточки JSON. Теперь убери фигурные скобки, кавычки и запятые, и разложи все как обычный список с отступами. Это YAML.

Те же три факта рядом. JSON:

YAML:

Ни скобок. Ни кавычек. Ни последней запятой, которую можно забыть. Просто подпись, двоеточие, значение и отступ, который показывает, что к чему относится. Читается почти как заметки, которые ты написал бы для себя.

Разделение в том, кто читает. JSON — то, что машины передают друг другу. YAML — то, что люди пишут, когда им нужно что-то настроить руками. Одна семья, разные аудитории.

Где ты реально его встретишь: настройки и config-файлы. Инструкции, которые говорят инструменту, как себя вести, часто живут в YAML-файле, который редактируешь ты или твой агент. Его приятнее открыть и поправить, чем стену из фигурных скобок, поэтому так много инструментов выбрали его для той части, к которой должен прикасаться человек.

Один подвох, потому что он кусает всех хотя бы раз: в YAML отступы и есть смысл. Эти пробелы не украшение. Сдвинь строку не туда или смешай табы с пробелами — и весь файл сломается так, что бесит искать, потому что глазу все еще кажется, будто он нормальный. Поэтому когда твой YAML "не грузится", а ты клянешься, что он выглядит идеально, сначала проверь отступы. Почти всегда дело в них.

Зачем это знать человеку, который не пишет код: когда инструмент говорит "отредактируй config в .yaml-файле", теперь ты знаешь, что это просто аккуратный список настроек с отступами, а не код. Обычно ты можешь поменять значение, включить или выключить что-то, задать имя, не трогая остальное вокруг. Просто уважай пробелы.

JSON — для машин. YAML — те же данные, разложенные для людей. Подпись, двоеточие, значение и отступ, который действительно имеет значение.