go 的 yaml.v2 库要求结构体字段必须导出（首字母大写）且通过 yaml 标签显式映射，否则无法访问字段，导致反序列化后结构体为空。本文详解原因、修复方法及最佳实践。
在 Go 中使用 gopkg.in/yaml.v2（或推荐升级至 gopkg.in/yaml.v3）将 YAML 数据反序列化为结构体时，一个常见却易被忽视的陷阱是：结构体字段必须是导出的（exported），即字段名需以大写字母开头；否则，即使 YAML 键名与字段完全匹配，yaml.Unmarshal 也无法设置该字段值——因为 unmarshaler 依赖 Go 的反射机制，而反射无法访问非导出（小写首字母）字段。
例如，原始代码中定义了：
type Config struct {
foo_bar string // ❌ 非导出字段：无法被 yaml 包访问
}
尽管 YAML 中存在 foo_bar: “https://foo.bar”，但 yaml.Unmarshal 对该字段完全“不可见”，因此 config 始终保持零值（空结构体 &{}）。
✅ 正确做法如下：
