应选gopkg.in/yaml.v3：它最稳定、兼容性好、社区主流（docker/helm/k8s client-go均已迁移）；v2存在空值panic、嵌套解析bug，go-yaml/yaml(v1)已归档；支持锚点、别名、严格模式及精确错误定位。
用 gopkg.in/yaml.v3 解析 YAML 文件最稳妥
Go 官方不带 YAML 支持，必须依赖第三方库。目前最主流、维护活跃、兼容 Go modules 的是 gopkg.in/yaml.v3（注意不是 v2，v2 已归档且不支持 map[string]any 等现代用法）。用 go get gopkg.in/yaml.v3 安装即可，别手滑装成 github.com/go-yaml/yaml —— 那是 v3 的镜像，但导入路径写错会导致版本混乱。
yaml.Unmarshal 读文件前得先 ioutil.ReadFile 或 os.ReadFile
YAML 解析函数本身只处理字节流，不直接读文件。Go 1.16+ 推荐用 os.ReadFile，比老式的 ioutil.ReadFile 更简洁：
data, err := os.ReadFile("config.yaml")
if err != nil {
log.Fatal(err)
}
var cfg struct {
Port int `yaml:"port"`
Host string `yaml:"host"`
}
err = yaml.Unmarshal(data, &cfg)
if err != nil {
log.Fatal(err)
}
常见错误：直接传文件路径给 yaml.Unmarshal —— 它根本不接受 string 路径，会编译失败。
结构体字段必须导出，且注意 yaml tag 的大小写和引号
YAML 键名默认按字段名小写匹配，但更可靠的方式是显式加 yaml tag。以下写法都合法：
-
Port int `yaml:"port"`→ 匹配port: 8080 -
Port int `yaml:"PORT"`→ 匹配PORT: 8080 -
Port int `yaml:"port,omitempty"`→ 解析时跳过空值，序列化时省略零值
容易踩的坑：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 字段未导出（小写开头）→ 解析后值始终为零值，无报错也无提示
- tag 写成
yaml:"Port"但 YAML 里是port: 8080→ 字段不被填充，静默失败 - 用了单引号或双引号包裹 tag 值（如
yaml:"'port'"）→ 编译不过
嵌套结构和动态字段用 map[string]any 或自定义类型
遇到不确定 key 名或需灵活扩展的配置（比如插件列表、环境变量映射），硬写结构体不现实。这时优先用 map[string]any：
var cfg map[string]any
err := yaml.Unmarshal(data, &cfg)
// cfg["database"] 是 map[interface{}]interface{}？不，v3 默认转成 map[string]any
注意：map[string]any 中的 any 对应 YAML 的基础类型（float64、string、bool、nil、[]any、map[string]any），不是 interface{}。若需强类型转换，得手动断言，比如 v := cfg["timeout"].(float64)。
更安全的做法是为嵌套部分单独定义结构体，再嵌入主结构体中 —— 这样既能享受编译期检查，又避免满屏类型断言。
真正麻烦的是混合类型字段（例如一个字段可能是字符串或对象），yaml.v3 不支持自动类型推导，必须靠两次解码或自定义 UnmarshalYAML 方法处理。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
