go中toml.unmarshal解析数组嵌套表字段为零值，主因是结构体字段未导出或标签错误；须首字母大写并用toml:"key"显式标注，双中括号[[servers]]定义数组，禁用[[parent.child]]非法语法，数字默认为float64，time.time需实现unmarshaltext。
Go 用 toml.Unmarshal 解析数组嵌套表时字段全为零值？
常见现象是：TOML 里写了多个 [[servers]] 表，结构体也定义了 []Server 字段，但解析后切片长度为 0 或每个元素字段全是零值。
根本原因不是语法错，而是 Go 结构体字段没导出（首字母小写）或标签写错。TOML 解析器依赖反射读取导出字段，且默认按字段名匹配，不自动处理下划线转驼峰。
- 确保结构体字段首字母大写（如
Address而非address） - 用
toml:"addr"标签显式指定 key 名，避免依赖默认映射 - 数组必须用双中括号
[[servers]]开头，单个[servers]会被当普通表，无法映射到切片 - 若 TOML 中有空表（如
[[servers]]下无字段），对应结构体实例字段仍为零值，属正常行为
# 正确的 TOML 数组写法 [[servers]] addr = "10.0.0.1" port = 8080 <p>[[servers]] addr = "10.0.0.2" port = 8081
嵌套表（[[parent.child]]）怎么映射？
TOML 规范不支持 [[parent.child]] 这种写法 —— 它是非法语法。解析器会直接报错 invalid array of tables definition 或静默失败。
真实需求其实是“数组里每个元素带子表”，正确写法是先定义父数组，再在每个 [[parent]] 块内展开子表字段，或用独立子数组。
- 错误：
[[servers.config]]→ 解析失败 - 正确一（扁平化）：
[[servers]]块内直接写timeout = 5、retries = 3 - 正确二（子结构体）：
Servers []struct{ Config Config }，其中Config是另一个结构体，TOML 中仍写在[[servers]]块内，靠字段标签对齐 - 正确三（独立子数组）：
[[servers]]+[[servers.endpoints]]不行；应改为[[servers]]和[[endpoints]]并通过 ID 关联
toml.Unmarshal 对 map 和 interface{} 的兼容性陷阱
如果结构体字段类型是 map[string]interface{} 或 interface{}，解析能成功，但后续取值极易 panic：比如想读 m["port"].(int)，实际可能是 float64（TOML 数字默认解析为 float64）。
- 数字一律是
float64，哪怕 TOML 写的是port = 8080 - 布尔值是
bool，字符串是string，但数组和表会变成[]interface{}或map[string]interface{} - 避免裸用
interface{}；优先定义具体结构体，或用类型断言+检查ok - 若必须用
map[string]interface{}，建议封装一层工具函数做安全取值，例如GetInt(m, "port")
自定义 Unmarshaler 处理特殊格式（如时间字符串）
TOML 本身不定义日期类型，只支持字符串。若结构体字段是 time.Time，toml.Unmarshal 默认无法解析，会报错 cannot unmarshal TOML string into time.Time。
- 必须让结构体实现
UnmarshalText方法，而不是UnmarshalTOML（后者是第三方库如go-tomlv2 的接口，标准库不支持） - 标准库
github.com/pelletier/go-toml/v2支持UnmarshalTOML，但老版本v1只认UnmarshalText - 示例：给
type Timestamp time.Time实现func (t *Timestamp) UnmarshalText(text []byte) error，内部用time.Parse - 注意：该方法只对字段字符串值生效；若 TOML 写成
at = 2023-01-01（无引号），会被当成整数解析，直接失败
最易被忽略的一点：TOML 解析器不会帮你做类型推导，所有语义都靠结构体定义和标签驱动。写错一个标签、漏一个导出符、多一层无效嵌套，结果就是静默丢数据 —— 它不报错，只是不填。
