go-toml读取toml文件时，结构体字段必须首字母大写（导出），否则被忽略且值为零值；若字段名与toml键不一致，须用toml:"key"显式标注；嵌套表对应嵌套结构体，数组表对应切片。
用 go-toml 读取 TOML 文件时，结构体字段必须导出且带 tag
Go 的 encoding/json 类似，go-toml（推荐用 github.com/pelletier/go-toml/v2）只处理导出字段（首字母大写），且默认按字段名匹配 TOML key。如果字段名和 TOML key 不一致，必须加 toml tag。
常见错误是定义了小写字段（如 port int）却没加 tag，结果解析后值为零值，也不报错。
- 确保结构体字段首字母大写（如
Port而非port） - 使用
toml:"port"显式指定映射关系，尤其当字段名含下划线或需忽略大小写差异时 - 嵌套表（table）对应嵌套结构体；数组表（
[[servers]]）对应切片，元素类型必须是结构体 - 未在结构体中声明的字段会被静默忽略，不会报错——调试时容易误以为数据丢了
Unmarshal 和 Decode 的区别：文件流 vs 字节切片
读取文件时，直接用 os.ReadFile + toml.Unmarshal 最简单；但如果要复用已打开的 *os.File 或需要流式解析（比如超大配置），就得用 toml.NewDecoder + Decode。
-
toml.Unmarshal([]byte, interface{})：适合小到中等配置，代码简洁，但整块加载进内存 -
toml.NewDecoder(io.Reader).Decode(&v)：支持从*os.File、strings.NewReader等任意io.Reader解析，更灵活，也便于单元测试（传入字符串模拟文件） - 注意：
Decode不会自动跳过 BOM，若文件带 UTF-8 BOM，需先 strip，否则解析失败并报invalid character 'ï' looking for beginning of value
写入 TOML 时，Marshal 默认不格式化，需手动控制缩进和换行
toml.Marshal 输出的是紧凑格式（无空行、无缩进），可读性差。生产环境写配置文件，应使用 toml.MarshalIndent 并指定缩进字符串（如 " "）。
-
toml.MarshalIndent(v, " ")生成带两级空格缩进、保留空行的可读输出 - 时间字段（
time.Time）会按 RFC 3339 格式序列化（如2024-05-20T14:23:11Z），无需额外处理 - 写入文件时务必用
os.WriteFile（原子写入），不要用os.OpenFile+Write，避免写到一半崩溃导致配置损坏 - 若结构体中有指针字段且为
nil，MarshalIndent会跳过该字段——不是 bug，是设计行为，但容易被当成“字段丢失”
遇到 cannot unmarshal TOML array into Go struct field 错误怎么办
这是最常搜到的错误之一，本质是 TOML 数组表（[[section]]）和 Go 结构体切片类型不匹配。典型场景：TOML 写了 [[databases]]，但结构体里定义的是 Databases Database `toml:"databases"`（单个 struct 而非 []Database）。
- 检查 TOML 中是否用了双括号（
[[x]]）——这表示数组表，Go 必须用切片接收：X []XItem `toml:"x"` - 单括号（
[x]）才是普通表，对应单个结构体字段 - 如果误把
[[servers]]当成[servers]解析，会触发该错误；反之，把[server]当成数组解析也会失败 - 用
toml.Unmarshal前先fmt.Printf("%s", data)确认原始字节内容，有时编辑器自动加了不可见字符（如零宽空格）也会导致类似报错
