TOML 语法速查表

把 TOML 配置文件最常用的语法整理成速查,写 Cargo.toml 等配置时对照查。

配置格式·共 30 条命令·最后更新 2026-07-19
返回 配置格式

基础类型 8

key = "value"
字符串
key = 'value'
字面量字符串(不转义)
int = 42
整数
float = 3.14
浮点数
bool = true
布尔值
date = 2026-07-19
日期
time = 14:30:00
时间
datetime = 2026-07-19T14:30:00Z
日期时间

字符串 4

str = "Hello\nWorld"
基本字符串(支持转义)
str = """Hello\nWorld"""
多行基本字符串
str = 'C:\\path\\to\'
字面量字符串(不转义)
str = '''C:\\path\\to\'''
多行字面量字符串

数组与表格 6

array = [1, 2, 3]
数组
array = ["a", "b", "c"]
字符串数组
[table]
表格(section)
key = "value"
表格内的键值对
[table.subtable]
子表格
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 的核心结构。