Go中使用gopkg.in/yaml.v2反序列化嵌套YAML时，若结构体字段名与YAML键名大小写不一致（如大驼峰字段Groups对应小写键Groups），需通过yaml标签显式指定映射关系，否则字段将被忽略。

go中使用gopkg.in/yaml.v2反序列化嵌套yaml时，若结构体字段名与yaml键名大小写不一致（如大驼峰字段`groups`对应小写键`groups`），需通过`yaml`标签显式指定映射关系，否则字段将被忽略。

在Go中使用 gopkg.in/yaml.v2 进行YAML反序列化时，一个常见误区是认为结构体字段名会自动与YAML中的键名（key）一一对应。实际上，YAML包默认使用字段名的小写形式作为键名，且仅导出字段（首字母大写）可被反序列化。但关键点在于：即使YAML中使用了首字母大写的键（如 Groups），只要结构体字段名为 Groups，其默认映射的YAML键应为 groups（全小写），而非 Groups。

因此，原始代码中：

thing1:
  Groups:  # ← YAML中是首字母大写的"Groups"
    - g1
    - g2
  Value:   # ← 同样是"Value"
    5

而结构体定义为：

type ThingAndGroups struct {
    Groups []string
    Value  int
}

此时，YAML包会尝试匹配小写键 groups 和 value，但实际YAML提供的是 Groups 和 Value —— 导致字段未被填充，输出为 [] 0。

✅ 正确做法是：使用 yaml struct tag 显式声明键名，保持与YAML内容完全一致：

type ThingAndGroups struct {
    Groups []string `yaml:"Groups"` // 显式绑定YAML键 "Groups"
    Value  int      `yaml:"Value"`  // 显式绑定YAML键 "Value"
}

完整可运行示例：

package main

import (
    "fmt"
    "log"
    yaml "gopkg.in/yaml.v2"
)

type ThingAndGroups struct {
    Groups []string `yaml:"Groups"`
    Value  int      `yaml:"Value"`
}

var someStr = `
thing1:
  Groups:
    - g1
    - g2
  Value: 5
`

func main() {
    t := make(map[string]ThingAndGroups)

    err := yaml.Unmarshal([]byte(someStr), &t)
    if err != nil {
        log.Fatalf("error: %v", err)
    }
    fmt.Printf("--- t:\n%+v\n", t)
    // 输出：--- t:
    // map[thing1:{Groups:[g1 g2] Value:5}]
}

⚠️ 注意事项：

• yaml tag 中的键名区分大小写，必须与YAML源文件中的键严格一致；
• 若希望采用更符合Go惯例的命名（如字段 Groups 对应YAML键 groups），则应统一修改YAML为小写键，并省略tag（或使用 `yaml:"groups"`）；
• 所有需反序列化的字段必须是导出字段（首字母大写），私有字段（如 groups []string）将被忽略；
• 使用 yaml:",omitempty" 可实现零值字段跳过序列化，但不影响反序列化行为。

总结：YAML结构体映射的核心原则是——字段导出 + 键名显式对齐。善用 yaml tag 是解决大小写不一致、缩写、保留字冲突等问题的最可靠方式。