yaml.Unmarshal解析失败却无报错，主因是结构体字段未导出（需首字母大写），蛇形命名需用yaml:"key_name"显式映射，且须先用os.ReadFile读取字节流再解析。
yaml.Unmarshal 解析失败但没报错？检查结构体字段是否导出
Go 的 yaml.Unmarshal 只能写入**导出字段**（首字母大写），小写字段会被静默忽略——这导致解析看似成功，但结构体里全是零值。
- 确保所有要解析的字段首字母大写，比如
Name而不是name - 如果 YAML 用的是蛇形命名（如
user_name），用 struct tag 显式映射：UserName string `yaml:"user_name"` - 嵌套结构体同理：内部结构体也必须是导出类型，且字段导出
YAML 文件路径读取失败：别直接传文件名给 yaml.Unmarshal
yaml.Unmarshal 只接受 []byte，不处理文件 I/O。传入文件路径字符串会触发类型错误或 panic。
- 先用
os.ReadFile读取内容：data, err := os.ReadFile("config.yaml") - 再传给
yaml.Unmarshal(data, &cfg) - 注意：Windows 换行、BOM 头、空格缩进不一致都可能让解析失败，建议用
strings.TrimSpace预处理（尤其测试时）
map[string]interface{} 解析后取值 panic？类型断言前先检查
用 interface{} 接收通用 YAML（比如配置片段）很常见，但后续取值时容易 panic——因为 Go 不做运行时类型自动转换。
- 不要直接写
v["ports"].([]interface{})[0].(float64)，先逐层断言并检查ok - 推荐用类型安全方式：先断言为
map[string]interface{}，再对每个 key 做if val, ok := v["timeout"]; ok { ... } - 数字在 YAML 中默认解析为
float64，即使写的是port: 8080；需要整数时记得int(val.(float64))
嵌套结构体字段缺失导致解析中断？用 yaml:",omitempty" 控制可选性
YAML 中某个嵌套字段完全不存在时，yaml.Unmarshal 默认会把对应结构体字段设为零值——这通常没问题；但如果该字段本身是必需的指针或有自定义 UnmarshalYAML 方法，就可能出问题。
立即学习“go语言免费学习笔记（深入）”；
- 对非必需字段加
yaml:",omitempty"tag，避免反序列化时强行初始化 - 对指针字段，用
*string+yaml:",omitempty"可区分“未设置”和“设为空字符串” - 如果某一层结构体全空（YAML 中该块被删了），它对应的字段不会被 touch，保持 nil 或零值——这点和 JSON 不同，要注意判空逻辑
