TOMLTOML配置编写

Strings

• - Basic strings "..." support escapes: \n, \t, \\, INLINECODE4
• Literal strings '...' are raw—no escape sequences, backslash is literal
• Multiline basic """...""" allows newlines; leading newline after """ is trimmed
• Multiline literal '''...''' for raw blocks; no escape processing

Keys

• - Bare keys: alphanumeric, dash, underscore only—key-name_1 valid
• Quoted keys for special chars: "key with spaces" or INLINECODE11
• Dotted keys a.b.c = 1 equivalent to nested tables—defines [a.b] implicitly
• Keys are case-sensitive—Key and key are different

Tables

• - [table] defines table; all following key-values belong to it until next header
• INLINECODE17 creates nested structure—parent tables created implicitly
• Dotted keys under [table] extend it: [fruit] then apple.color = "red" works
• Defining table after dotted key created it is error—order matters

Arrays of Tables

• - [[array]] appends new table to array each time it appears
• INLINECODE22 twice creates products[0] and INLINECODE24
• Mix [array.nested] after [[array]] to add to most recent array element
• Cannot redefine static table as array or vice versa

Inline Tables

• - point = { x = 1, y = 2 } for compact single-line tables
• Inline tables cannot span lines (until TOML 1.1)
• Cannot add keys to inline table after definition—immutable once closed
• Nested inline tables allowed but reduce readability

Types

• - Integers: decimal, hex 0xDEAD, octal 0o755, binary INLINECODE30
• Underscores for readability: 1_000_000 is valid
• Floats: 3.14, 5e-10, inf, nan (case-sensitive)
• Booleans: true/false only—lowercase, no yes/no/on/off

Dates & Times

• - RFC 3339 format: 2024-01-15T14:30:00Z or with offset INLINECODE39
• Local datetime: 2024-01-15T14:30:00 (no timezone)
• Local date: 2024-01-15; Local time: INLINECODE42
• Milliseconds supported: INLINECODE43

Common Pitfalls

• - No null type—omit key entirely for optional values
• Arrays must be homogeneous (TOML 1.0)—TOML 1.1 allows mixed types
• Trailing commas not allowed in arrays or inline tables
• Comment # only outside strings—no inline comment after value on same line works, but avoid ambiguity