TOML 语法速查表 - TOML 配置文件常用命令大全
Cargo、Hugo 等现代工具的配置都用 TOML，它用明确的 [table] 和 key = value 让配置比 JSON 更易读，还支持注释。这份速查按 6 组整理：基础类型、日期时间、四种字符串写法、数组与表格、数组表格，以及一份可直接套用的 Cargo.toml 示例。写依赖表或嵌套 section 时对照结构，遇到字符串转义、日期时区时按组查询，避免常见的类型与结构歧义。读完你就能独立维护 Cargo.toml 这类 TOML 配置。
基础类型 11
# 这是注释注释（# 到行尾）
key = "value"字符串（双引号，支持转义；需要换行或特殊字符时用）
key = 'value'字面量字符串（不转义）
int = 42整数
hex = 0xFF十六进制整数
oct = 0o17八进制整数
bin = 0b101二进制整数
num = 1_000_000下划线分隔（提高可读性）
float = 3.14浮点数（3.14；inf/-inf/nan 为特殊值）
flt = inf特殊浮点值（inf / -inf / nan）
bool = true布尔值（true/false；勿加引号否则变成字符串）
日期时间 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]开发依赖
提示
- TOML 目标是可读性优先，比 JSON 更适合配置文件。
- 字符串分基本字符串（双引号，支持转义）和字面量字符串（单引号，不转义）。
- 表格 [table] 和数组表格 [[array]] 是 TOML 的核心结构。
由 巧匠 维护
公开更新于 2026年7月21日，内容持续校对官方文档。