素材阁

TOML 速查

共 22 条 TOML 配置语法,涵盖基础语法、表与嵌套、数组、字符串与日期、解析工具。 支持搜索与分类筛选,点击即可复制。

基础语法

配置文件常用格式,语义清晰。

命令说明
键值对(等号两侧可留空格)
整数 / 浮点 / 布尔
注释
基本字符串(双引号,支持转义)
字面量字符串(单引号,不转义)

表与嵌套

用 [表名] 组织层级。

命令说明
普通表
嵌套表(点号)
多层嵌套
内联表
点号键直接定义(无需 [server])

数组

数组与表数组。

命令说明
普通数组
多行数组(末尾逗号允许)
表数组([[ ]])
混合类型(TOML 1.0 允许)

字符串与日期

多行与时间类型。

命令说明
多行基本字符串
多行字面量字符串
日期与日期时间
时间类型

解析工具

常见语言的解析方式。

命令说明
Python 标准库解析
JS 生态解析库
taplo:格式化与校验
常见使用场景

使用说明

TOML 速查:基础语法、表与嵌套、数组、字符串与日期、解析工具;支持搜索与分类筛选,点击即可复制。

  1. 按用途点分类:基础语法、表与嵌套、数组、字符串与日期、解析工具。
  2. 点「命令」列复制到配置文件。
  3. 用 [table]、[[array of table]] 组织层级;点号键可直接定义嵌套。
  4. 路径类字符串优先用单引号字面量,避免转义烦恼。

常见问题

TOML 和 YAML 怎么选?
TOML 直白、适合配置(Cargo.toml、pyproject.toml);YAML 表达力强但缩进敏感,常见于 CI 与 k8s。
[table] 和 [[table]] 的区别?
单中括号是表,双中括号是表数组(每个块是数组的一个元素,适合重复条目)。
需要联网吗?
不需要,本地可用。

延伸阅读

相关工具