Go中使用toml.DecodeFile读配置时，结构体字段必须首字母大写才能被反射识别，小写字段会被忽略且值为零值；嵌套表、时间字段（需time.Time类型并带时区）、数组等均需严格匹配类型，推荐使用pelletier/go-toml/v2替代已归档的BurntSushi/toml。
用 toml.DecodeFile 读配置，结构体字段必须首字母大写
Go 的反射机制只能访问导出（public）字段，toml.DecodeFile 依赖反射把 TOML 键映射到 struct 字段——小写字段会被直接忽略，不报错但值永远是零值。
- 错误写法：
type Config { age int }→age永远为0 - 正确写法：
type Config { Age int }，且 TOML 中的键名（如age）默认按小写匹配，也可用 tag 显式指定：Age int `toml:"age"` - 嵌套表（如
[database]）必须对应一个导出的 struct 字段，不能是匿名 struct 字面量 - 时间字段（如
2022-01-01T00:00:00Z）需声明为time.Time类型，否则解析失败或 panic
写 TOML 用 toml.NewEncoder，别手拼字符串
手动拼接 TOML 字符串极易出错：缩进混乱、引号遗漏、数组/表嵌套格式错位，而且无法自动转义特殊字符（比如含换行的 bio 字段）。
- 正确方式是用
toml.NewEncoder(file).Encode(conf)，它会严格遵循 TOML 规范输出 - 注意：
os.OpenFile(..., os.O_WRONLY|os.O_TRUNC, 0644)才能覆盖写入；若用os.Create，旧文件被清空但权限可能不对 - 如果结构体字段没加
toml:tag，默认用 Go 字段名（大驼峰）转成小写+下划线，例如ConnMax→conn_max；想保持原样就加`toml:"ConnMax"`
github.com/BurntSushi/toml 不支持运行时修改树状结构
这个库只做“一次解码→struct”和“struct→一次编码”，没有类似 JSON 的 map[string]interface{} 动态树操作能力。想改某个子项再写回？必须先完整解码进 struct，改字段，再全量重写。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 要动态增删键、遍历表、条件修改某一层级？得换库，比如
github.com/pelletier/go-toml/v2（v2 版本支持toml.Unmarshal/toml.Marshal和toml.TreeAPI） - 用
BurntSushi/toml硬搞“部分更新”，容易漏掉未显式赋值的字段（它们会变成零值），导致配置丢失 - v1 库已归档，新项目建议直接上 v2，API 更现代，对数组、嵌套表、datetime 的处理也更鲁棒
嵌套表和数组字段类型必须严格匹配
TOML 的 [[servers]] 是数组中的表（array of tables），不是单个 [servers] 表；Go struct 中必须用切片接收，否则解析静默失败或 panic。
立即学习“go语言免费学习笔记（深入）”；
-
[[servers.alpha]]是非法语法 —— TOML 不允许点号嵌套表，正确写法是[[servers]]+name = "alpha" - 对应 Go 结构体：
Servers []Server `toml:"servers"`，不是map[string]Server - 多维数组如
hosts = [ ["a", "b"], ["c"] ]，需声明为[][]string；若声明为[]string，解析会失败且错误信息模糊（常见报错：cannot unmarshal TOML array into string）
最常被忽略的是：TOML 时间字面量必须带时区（如 Z 或 +08:00），time.Time 字段才能成功解析；缺时区会返回零时间，也不报错。这点比 YAML 严格得多。
