推荐使用 map[string]interface{} 直接解析 YAML，因其轻量灵活、支持嵌套与混合类型；需注意空字段为 nil、数字默认为 float64、深层访问应封装安全取值函数，优先选用 gopkg.in/yaml.v3。
直接用 yaml.Unmarshal 解析到 map[string]interface{}
Go 的 gopkg.in/yaml.v3（推荐）或 gopkg.in/yaml.v2 都支持将 YAML 字符串直接反序列化为 map[string]interface{}，这是最轻量、最常用的方式。它不依赖预定义结构体，适合配置解析、前端传参、模板渲染等动态场景。
常见错误是误用 map[string]string——YAML 支持嵌套、数组、布尔、数字等类型，map[string]string 会丢数据或 panic。
- 必须用
map[string]interface{}，否则嵌套字段或非字符串值（如true、123、[a, b]）无法正确映射 - 如果 YAML 含顶层数组（如
- name: a），需用[]interface{}接收，而非map -
yaml.Unmarshal对空字段（null）默认映射为nil，访问前务必判空
注意数字类型的自动转换行为
YAML 中的 123、1.5、0x1F 默认被解析为 float64（v2 和 v3 均如此），不是 int 或 int64。这在做类型断言时极易出错：
data := map[string]interface{}{}
yaml.Unmarshal([]byte("age: 25"), &data)
age := data["age"].(int) // panic: interface{} is float64, not int
正确做法是先断言为 float64，再转整型（若确定是整数）：
立即学习“go语言免费学习笔记（深入）”；
v, ok := data["age"].(float64); if ok { age := int(v) }- 若需保留原始精度（如 ID 是大整数），建议统一用
float64或用json.Number配合自定义 unmarshaler（较重，一般不需要） - YAML v3 支持
yaml.Node手动解析，可避免类型擦除，但开发成本高，仅当必须区分1和1.0时考虑
处理嵌套结构和类型安全访问
map[string]interface{} 是树状结构，深层字段访问容易 panic。别写 data["user"].(map[string]interface{})["name"].(string) 这种链式断言——任何一层为空或类型不符都会崩溃。
- 用辅助函数封装安全取值，例如：
GetMapString(data, "user", "name")，内部逐层检查map[string]interface{}和类型 - 第三方库如
github.com/mitchellh/mapstructure可把map[string]interface{}转成 struct，但失去“动态”特性；若只是临时读取，不如手写几行安全访问逻辑 - YAML 中的
!!bool、!!null等显式 tag 会被正确识别，但!!int仍进float64，无实质区别
兼容性与性能提醒：v2 vs v3
当前主流是 gopkg.in/yaml.v3，它修复了 v2 的多个 corner case（如锚点引用、多文档、空 map 处理），且 API 更干净。但要注意：
- v3 默认禁用
unsafe特性（如解析任意 struct），更安全；v2 允许反射写私有字段，存在隐患 - v3 解析速度略慢于 v2（约 10–15%），但对大多数配置场景无感
- 若项目已用 v2 且无升级计划，只需确认导入路径是
gopkg.in/yaml.v2，函数名和用法一致 - 不要混用两个版本——同一模块里同时 import v2 和 v3 会导致类型冲突（
yaml.Marshal返回类型不同）
真正麻烦的是混合类型字段（比如某个 key 有时是 string，有时是 list），Go 的 interface{} 无法静态约束，只能靠运行时校验或 schema 验证工具补位。
