Format Atlas

对比

YAML vs TOML

YAML 和 TOML 都是用于人工维护配置的文本格式。YAML 支持灵活的层级结构;TOML 更强调通过键和值、表格明确而易读地表达设置。应根据工具和数据结构选择。

应该选择哪种格式?

工具要求 YAML 或配置需要复杂嵌套时用 YAML。普通应用设置若需要清晰的表格和类型,可考虑 TOML。

适用于 YAML

配置文件和结构化数据编写

  • 由人维护的配置

适用于 TOML

应用程序和工具配置

  • 带结构化值的可读设置

基本信息

项目YAMLTOML
扩展名.yaml, .yml.toml
MIME 类型application/yamlapplication/toml
常见用途配置文件和结构化数据编写应用程序和工具配置
打开方式可使用文本编辑器或YAML工具打开,并保留空格缩进。用文本编辑器打开,并查看应用支持的 TOML 功能。
导出或转换当接收方要求JSON时请转换,并检查值类型和字符编码。从 JSON 或 YAML 转换时,解析后检查嵌套、数组、引号、日期和值类型。

按用途选择

由人维护的配置

配置文件和结构化数据编写

YAML

带结构化值的可读设置

应用程序和工具配置

TOML

关键点 1

YAML 能表达丰富的层级结构,但需要注意缩进和隐式类型规则。

进一步了解差异

关键点 2

TOML 使用明确的键值与表格语法,侧重配置的可读性。

进一步了解差异

进一步了解差异

遵循目标工具支持的格式和版本。用实际解析器及模式验证文件,重点检查日期、数字、嵌套数据和对空白敏感的语法。

  • 基础设施和自动化工具中,要求 YAML 的情况很常见。
  • TOML 可让应用设置更清晰,但并非所有 YAML 工具都接受 TOML。
  • 解析器设置或类型规则不同时,两种格式都可能被误解。

常见问题

TOML 比 YAML 简单吗?

对许多简单配置而言可能如此,但仍应按工具要求和数据结构决定。请选择应用可靠支持的格式。

了解详情

相关用途与检查步骤

选择配置文件格式

参考资料与规范