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}]
}⚠️ 注意事项：
-
yamltag 中的键名区分大小写，必须与YAML源文件中的键严格一致； - 若希望采用更符合Go惯例的命名（如字段
Groups对应YAML键groups），则应统一修改YAML为小写键，并省略tag（或使用`yaml:"groups"`）； - 所有需反序列化的字段必须是导出字段（首字母大写），私有字段（如
groups []string）将被忽略； - 使用
yaml:",omitempty"可实现零值字段跳过序列化，但不影响反序列化行为。
总结：YAML结构体映射的核心原则是——字段导出 + 键名显式对齐。善用 yaml tag 是解决大小写不一致、缩写、保留字冲突等问题的最可靠方式。
