TOML（Tom‘s Obvious, Minimal Language）配置文件格式基本用法和特性汇总

本文主要是介绍TOML（Tom‘s Obvious, Minimal Language）配置文件格式基本用法和特性汇总，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

- - 基础语法
  - 数据类型
  - 高级特性
  - 使用场景

TOML（Tom’s Obvious, Minimal Language）是一种旨在易于读写的配置文件格式。它用于配置文件的编写，其设计哲学是简洁明了，易于人类理解和编辑，同时也易于机器精确解析。TOML的语法类似于INI文件，但提供了更丰富的数据类型和结构。以下是TOML的一些基本用法和特性汇总：

基础语法

键值对：最基本的组成部分，用等号=分隔键和值。
```
key = "value"
```
表（Tables）：使用方括号[]定义，表示一组相关的值。
```
[table]
key = "value"
```
数组：使用方括号[]表示，元素之间用逗号,分隔。
```
array = [1, 2, 3]
```
内联表：使用大括号{}定义，允许在一行内表示一个表。
```
inline_table = { key = "value", another_key = "another value" }
```
多行字符串：使用三个双引号"""或三个单引号'''包裹。
```
multi_line_string = """
This is a
multi-line string.
"""
```

数据类型

字符串：可以是基本字符串（使用双引号"）或字面字符串（使用单引号'）。
整数：直接写数字，支持十进制、十六进制、八进制和二进制。
浮点数：支持标准的浮点数表示。
布尔值：true或false。
日期和时间：TOML支持各种ISO 8601日期、时间和日期时间格式。

高级特性

数组表：使用双方括号[[ ]]定义，用于表示对象数组。

[[products]]
name = "Hammer"
sku = 738594937[[products]]
name = "Nail"
sku = 284758393

注释：使用井号#开始，直至行末。

# This is a comment
key = "value" # Inline comment

点分隔：用于表示嵌套的表。

[owner]
name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00Z[owner.bio]
city = "San Francisco"

在 TOML 中，表是键值对的集合，其中的值可以是基本数据类型（如字符串、整数、布尔值等）、数组、表，甚至是嵌套的表。

下面是一个 TOML 文件的示例，展示了如何表示值为基本数据类型、数组、表，以及嵌套表的情况：

# 基本数据类型
title = "TOML Example"
description = "This is a TOML file."
number = 42
is_nice = true
temperature = 25.5
date = 1979-05-27T07:32:00Z# 数组
colors = ["red", "yellow", "green"]
ports = [80, 443, 8080]
temperatures = [22.1, 23.4, 24.8]# 表
[owner]
name = "John Doe"
dob = 1979-05-27T07:32:00Z# 嵌套的表
[database]
server = "192.168.1.1"
ports = [ 8001, 8001, 8002 ]
enabled = true# 嵌套在 database 下的 settings 表[database.settings]max_connections = 500timeout_seconds = 30# 表数组（数组的每个元素都是一个表）
[[products]]
name = "Hammer"
sku = 738594937[[products]]
name = "Nail"
sku = 284758393# 嵌套的表数组
[[servers]]
name = "alpha"
ip = "10.0.0.1"
role = "frontend"[[servers.services]]name = "http"port = 80[[servers.services]]name = "https"port = 443[[servers]]
name = "beta"
ip = "10.0.0.2"
role = "backend"[[servers.services]]name = "database"port = 3306

这个 TOML 文件示例包括了：

基本数据类型：字符串（title）、整数（number）、布尔值（is_nice）、浮点数（temperature）和日期时间（date）。
数组：字符串数组（colors）、整数数组（ports）和浮点数数组（temperatures）。
表：使用方括号定义的键值对集合，例如 [owner]。
嵌套表：表内部可以包含其他表，例如 [database] 内部的 [database.settings]。
表数组：一系列具有相同结构的表，用两个方括号定义，例如 [[products]] 和 [[servers]]。
嵌套的表数组：表数组内部的表可以包含其他表或表数组，例如 [[servers]] 内部的 [[servers.services]]。