Go-yaml 默认不序列化嵌套结构体的零值字段，需初始化或移除 omitempty；map 顺序混乱应改用 yaml.MapSlice；复杂逻辑需实现 MarshalYAML() 方法。
Go-yaml 默认不支持直接序列化嵌套结构体的零值字段（比如空 slice、nil map、未初始化的 struct 字段），除非显式配置标签或启用特定选项。这是最常踩的坑——你以为写进去了，实际 YAML 输出里字段直接消失。
嵌套结构体字段不出现？检查 omitempty 标签和零值行为
Go-yaml（即 gopkg.in/yaml.v3）默认遵循 Go 的 struct tag 规则：yaml:",omitempty" 会让零值字段被跳过。嵌套 struct 中哪怕只有一层是零值（比如 Config.Database 是 nil 或空 struct），整个字段就不出现在输出里。
- 确认所有嵌套字段都已初始化，例如：
config.Database = &DatabaseConfig{}，而不是留空或 nil - 避免在嵌套字段上误加
omitempty—— 比如type Server struct { Port int `yaml:"port,omitempty"` }，如果 Port=0 就不会输出，但 0 是合法端口值 - 若需强制输出零值字段，去掉
omitempty，或改用yaml:",flow"等控制格式，不改变存在性
map[string]interface{} 嵌套时 key 顺序混乱？用 yaml.MapSlice 替代
YAML 规范要求 mapping 保持插入顺序，但 Go 原生 map 无序，yaml.Marshal 直接序列化 map[string]interface{} 会导致字段顺序随机，对配置文件可读性和 diff 友好性很不友好。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 改用
yaml.MapSlice类型（来自gopkg.in/yaml.v3）：它是一个[]yaml.MapItem切片，能保留顺序 - 手动构造时注意：每个
yaml.MapItem的Key必须是基本类型（string/int/bool），Value可递归嵌套yaml.MapSlice或 struct - 示例：
data := yaml.MapSlice{ {"version", "1.0"}, {"services", yaml.MapSlice{{"api", yaml.MapSlice{{"port", 8080}}}}}, }
自定义 marshaler 处理复杂嵌套逻辑？实现 MarshalYAML() 方法
当嵌套对象需要运行时计算字段（如根据环境动态生成 URL）、隐藏敏感字段、或统一处理时间格式时，靠 struct tag 不够用，必须介入序列化流程。
立即学习“go语言免费学习笔记（深入）”；
- 为嵌套 struct 实现
MarshalYAML() (interface{}, error)方法，返回要序列化的中间值（可以是 map、struct 或 primitive） - 注意：该方法只影响当前 struct 层级，内部嵌套字段仍走默认逻辑，除非它们也实现了该方法
- 避免在
MarshalYAML中调用yaml.Marshal自身，会引发无限递归；应返回纯数据结构（如map[string]interface{}） - 常见场景：把
time.Time转成 ISO8601 字符串、把url.URL转成string、过滤掉Password字段
嵌套越深，字段初始化和零值判断越容易漏；yaml.Marshal 不报错也不警告，静默丢字段是常态。上线前务必用 yaml.Unmarshal 再反序列化一次，比对原始 struct 和还原后的值，尤其关注指针字段和 map/slice 是否为空。
