toml.decodefile解析嵌套toml必须用嵌套结构体、全导出字段（首字母大写）且类型严格匹配，否则静默填零；小写字段反射不可见，类型不匹配（如port="8080"配port int）也不报错但值为0。
toml.DecodeFile 能解析嵌套 TOML，但必须用嵌套结构体 + 全导出字段 + 类型严格匹配，否则静默填零——不是没读到，是 Go 反射根本看不见小写字段或类型不兼容的字段。
嵌套表（如 [database]）必须用嵌套 struct，不能用 map[string]interface{}
常见错误现象：Database map[string]interface{} 声明后，config.Database["host"] 为 nil 或 panic；实际解析过程压根没往这个 map 里塞任何键值。
- 正确做法：定义
Database DatabaseConfig字段，其中DatabaseConfig是独立结构体，含Host string、Port int等首字母大写的导出字段 - 错误写法：
Database map[string]interface{}或Database struct{ Host string }（匿名结构体字段未导出） - 嵌套 struct 内部字段也必须首字母大写，哪怕外层已导出——Go 反射不递归处理非导出字段
[[servers]] 数组型表必须用切片接收，不能用 map 或数组字面量
常见错误现象：TOML 写了 [[servers]]\nname = "api"\nport = 8080\n[[servers]]\nname = "worker"\nport = 8081，但程序中 len(config.Servers) 为 0 或 panic。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
- 必须声明为
Servers []ServerConfig，其中ServerConfig是导出结构体 - 不能用
Servers [2]ServerConfig（固定长度数组不支持动态解析） - 不能用
Servers map[string]ServerConfig（[[...]]不是键值映射，是有序列表） - 若需按 name 查找，解析后手动建 map：
byName := make(map[string]ServerConfig); for _, s := range config.Servers { byName[s.Name] = s }
内联表（如 owner = { name = "...", dob = ... }）仍需 struct，不能靠 map[string]string
常见错误现象：TOML 中 owner = { name = "Alice", dob = 2000-01-01T00:00:00Z }，但用 Owner map[string]string 接收后，dob 是字符串，无法自动转 time.Time，时区信息丢失。
- 必须声明为
Owner OwnerConfig，其中OwnerConfig含Name string和Dob time.Time - 若字段名与 TOML 键不一致（如
connection_max），加 tag：ConnectionMax int `toml:"connection_max"` - 内联表和普通表在解析逻辑上无区别，只是语法糖；BurntSushi/toml 不做特殊处理，全靠结构体字段对齐
类型不匹配和小写字段导致的“静默失败”最危险
错误往往不报 panic 或明显 error：比如 Port int 对应 TOML 中 port = "8080"（字符串），toml.DecodeFile 返回 err == nil，但 config.Port 是 0；又或者 port int（小写）永远为 0，连 warning 都没有。
- 所有结构体字段必须首字母大写（
Port，不是port） - TOML 的数字默认当
float64解析，要存为int或uint16，必须确保 TOML 里写的是无引号数字（port = 8080），而非port = "8080" - 布尔值只认裸写
enabled = true，不接受"true"字符串 - 时间字段必须声明为
time.Time才能解析 ISO8601 格式；用string就纯字符串保留，失去校验能力
真正容易被忽略的点是：嵌套层级越深，字段导出要求越严格，且每一层的类型都必须和 TOML 值精确对应——没有隐式转换，也没有 fallback 逻辑。写完结构体后，建议对照 TOML 文件逐行检查大小写、类型、嵌套层级是否完全对齐。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
