.yaml · application/yaml

YAML: YAML 数据序列化语言 (YAML Ain't Markup Language)

YAML 1.2 是一种基于缩进的数据序列化语言,支持 # 注释、锚点引用、多行字符串以及以 --- 分隔的多文档流。

快速解答: YAML 1.2 是一种基于缩进的数据序列化语言,支持 # 注释、锚点引用、多行字符串以及以 --- 分隔的多文档流。 Kubernetes 清单、GitHub Actions 工作流、Docker Compose 文件以及人工维护的配置文件。

结构类型层级结构
人类可读性高
支持嵌套支持
LLM Token 效率中
文件扩展名.yaml
MIME 类型application/yaml
适用场景Kubernetes 清单、GitHub Actions 工作流、Docker Compose 文件以及人工维护的配置文件。

核心优势

  • 支持行内 # 注释与清爽的多行文本块,无需花括号包裹
  • 支持在单文件内通过 --- 分隔存放多个独立文档
  • JSON 的超集,在运维配置场景中可读性极佳

局限与权衡

  • 缩进空格数微小失误就可能悄悄破坏数据结构
  • YAML 1.1 中未加引号的 NO 或 ON 会被意外解析为布尔值
  • 复杂规范与锚点别名机制增加了解析实现复杂度

参考资料

本地转换与清理 YAML

相关工程指南

YAML 常见问题

什么是 YAML 中的“挪威问题”(Norway problem)?

在 YAML 1.1 中,未加引号的国家代码 NO 以及 yes/on/off 会被当成布尔值而非字符串。对易歧义值加引号或转为 JSON 核验即可避免。

单个 YAML 文件能否包含多个文档?

可以。Kubernetes 清单常使用 --- 分隔多个资源对象,TxtTo 的 YAML 转 JSON 支持多文档 loadAll 解析。

.yml 与 .yaml 文件有本质区别吗?

没有区别。两者语法完全一致,官方推荐 .yaml,而 .yml 在 CI 和 Docker 配置中仍很常见。