TOML Cheatsheet - TOML Configuration Reference
把 TOML 配置文件最常用的语法整理成速查，写 Cargo.toml 等配置时对照查。
Back to Config Formats基础类型 11
# 这是注释注释（# 到行尾）
key = "value"字符串
key = 'value'字面量字符串（不转义）
int = 42整数
hex = 0xFF十六进制整数
oct = 0o17八进制整数
bin = 0b101二进制整数
num = 1_000_000下划线分隔（提高可读性）
float = 3.14浮点数
flt = inf特殊浮点值（inf / -inf / nan）
bool = true布尔值
日期时间 5
date = 2026-07-19本地日期
time = 14:30:00本地时间
datetime = 2026-07-19T14:30:00本地日期时间（无时区）
datetime = 2026-07-19T14:30:00ZUTC 日期时间
datetime = 2026-07-19T14:30:00+08:00带时区偏移的日期时间
字符串 4
str = "Hello\nWorld"基本字符串（支持转义）
str = """Hello\nWorld"""多行基本字符串
str = 'C:\\path\\to\'字面量字符串（不转义）
str = '''C:\\path\\to\'''多行字面量字符串
数组与表格 6
array = [1, 2, 3]数组
array = [\n 1,\n 2,\n 3,\n]数组可跨行（末尾逗号可选）
[table]表格（section）
[table.subtable]子表格（点号分隔表名）
physical.color = "orange"点号键（dotted keys，等价子表格）
inline = { key1 = "value1", key2 = 2 }内联表格
数组表格 4
[[products]]数组表格（第一个元素）
name = "Apple"数组表格的字段
[[products]]数组表格（第二个元素）
name = "Banana"数组表格的字段
Cargo.toml 示例 8
[package]包信息
name = "myapp"包名
version = "0.1.0"版本号
edition = "2021"Rust 版本
[dependencies]依赖
serde = "1.0"依赖版本
serde = { version = "1.0", features = ["derive"] }带 feature 的依赖
[dev-dependencies]开发依赖
💡 Tips
- TOML 目标是可读性优先，比 JSON 更适合配置文件。
- 字符串分基本字符串（双引号，支持转义）和字面量字符串（单引号，不转义）。
- 表格 [table] 和数组表格 [[array]] 是 TOML 的核心结构。