⚙️

TOML 语法速查

表、数组、内联表与多行字符串等 TOML 语法速查。

本地处理 · 不上传

加载工具中…

相关:TOML · 语法 · 配置 · Cargo · pyproject

表、数组、内联表与多行字符串等 TOML 语法速查。它的设计目标是人易读易写,没有 YAML 的缩进陷阱,也比 JSON 更适合手工编辑。

使用步骤

  1. 按键值、表、数组、内联表分类找写法
  2. 注意表头用方括号,数组表用双方括号
  3. 多行字符串用三引号,注意首行换行的处理
  4. 写完用解析器校验,缩进不影响语义但拼写会

使用场景

  • 编写配置文件
  • 理解表与表数组的语法
  • 对照其他配置格式
  • 查阅语法写法

小贴士

  • TOML 的设计目标是无歧义,类型必须显式。相比 YAML 不依赖缩进,不易出错。
  • 方括号定义表(嵌套对象),双方括号定义表数组,这两个语法是理解 TOML 结构的关键。
  • 它不依赖缩进表达层级,因此不会出现 YAML 那类因空格数量导致的隐蔽错误。

常见问题

双方括号是什么意思?

表数组。每出现一次就往同名数组中追加一个元素,对应 JSON 中的对象数组。单方括号则是定义一个嵌套的表(对象)。这是初学时最容易混淆的一对。

比 YAML 好在哪?

不依赖缩进,因此不会出现空格数量导致的隐蔽错误;类型明确,没有 yes 被解析成布尔那类隐式转换陷阱。代价是深层嵌套写起来比 YAML 啰嗦。

支持哪些数据类型?

字符串、整数、浮点、布尔、日期时间、数组与表。原生支持日期时间是它的一个特点——不必像 JSON 那样只能用字符串再自行解析。

TOML 语法速查是免费的吗?

是。本站所有工具完全免费,无需注册登录、无广告干扰,打开即用。

使用TOML 语法速查,我的数据安全吗?

安全。该工具在你的浏览器本地完成处理,输入内容不会上传到服务器,隐私更有保障。