1- 什么是TOML？

TOML（Tom’s Obvious, Minimal Language）是一种配置文件格式，旨在提供一种简单、直观的方式来表示配置数据。它由GitHub的联合创始人Tom Preston-Werner于2013年创建，目标是成为一种易于阅读和编写的最小化配置文件格式。

2- 基本语法和结构

2.1- 键值对

TOML文件的基本单位是键值对（key-value pair），键和值之间用等号（=）分隔，键名不区分大小写。

title = "TOML 示例"

2.2- 注释

使用井号（#）来添加注释，注释内容从井号开始直到行尾。

# 这是一个注释
title = "TOML 示例"

2.3- 表格（Tables）

表格用于组织和分组键值对，表格名用方括号（[]）括起来。

[owner]
name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00Z

2.4- 嵌套表格

可以使用点号（.）来表示嵌套表格。

[servers.alpha]
ip = "10.0.0.1"
dc = "eqdc10"

[servers.beta]
ip = "10.0.0.2"
dc = "eqdc10"

2.5- 数组

数组用方括号（[]）表示，元素之间用逗号分隔。

ports = [ 8001, 8001, 8002 ]

2.6- 数据类型

TOML支持多种数据类型，包括字符串、整数、浮点数、布尔值和日期时间。

title = "TOML 示例"
enabled = true
max_connections = 5000
pi = 3.14159
dob = 1979-05-27T07:32:00Z

3- 示例代码解释

下面是一个完整的TOML文件示例，并对其进行详细解释：

# 这是一个TOML文件示例
title = "TOML 示例"

[owner]
name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00Z  # 日期时间

[database]
server = "192.168.1.1"
ports = [ 8001, 8001, 8002 ]
connection_max = 5000
enabled = true

[servers]

  [servers.alpha]
  ip = "10.0.0.1"
  dc = "eqdc10"

  [servers.beta]
  ip = "10.0.0.2"
  dc = "eqdc10"

• title：一个简单的键值对，表示配置文件的标题。
• [owner]：一个表格，包含所有者的信息。
  • name：所有者的名字。
  • dob：所有者的出生日期，使用ISO 8601格式。
• [database]：一个表格，包含数据库的配置信息。
  • server：数据库服务器的IP地址。
  • ports：一个数组，包含数据库服务器的端口号。
  • connection_max：最大连接数。
  • enabled：一个布尔值，表示数据库是否启用。
• [servers]：一个表格，包含服务器的配置信息。
  • [servers.alpha]：嵌套表格，表示alpha服务器的配置信息。
    • ip：alpha服务器的IP地址。
    • dc：alpha服务器的数据中心。
  • [servers.beta]：嵌套表格，表示beta服务器的配置信息。
    • ip：beta服务器的IP地址。
    • dc：beta服务器的数据中心。

4- 与JSON和YAML的对比

4.1- 图表展示

pie title 配置文件格式对比
    "可读性": 30
    "数据类型支持": 25
    "层次结构": 20
    "文件大小": 15
    "解析速度": 10

5- 总结

TOML是一种非常适合配置文件的格式，具有高可读性和易用性。它支持多种数据类型和嵌套结构，能够很好地表示复杂的配置数据。与JSON和YAML相比，TOML在可读性和配置文件的灵活性上具有明显优势，但在工具支持和解析速度上可能稍逊一筹。