应选gopkg.in/yaml.v3：它最稳定、兼容性好、社区主流（docker/helm/k8s client-go等均已迁移）；v2存在空值panic、嵌套解析bug，go-yaml/yaml(v1)已归档；支持锚点、别名、严格模式及精确错误定位。
直接用 gopkg.in/yaml.v3 解析 YAML 字节流最稳妥
别碰 gopkg.in/yaml.v2，它对空值、嵌套 map 和多文档支持有已知 panic；go-yaml/yaml（v1）早已归档。当前 Kubernetes 生态（client-go、Helm、KubeEdge、Podman）全部统一使用 v3，它原生支持锚点、别名、严格模式和精确错误定位。
解析流程就是两步：读文件 → 调用 yaml.Unmarshal。不需要额外包装或桥接库（比如 sigs.k8s.io/yaml 只在需要复用 json: tag 时才用，普通配置解析纯属多余）。
-
yaml.Unmarshal接收[]byte和指针，不接受io.Reader；务必先用os.ReadFile或ioutil.ReadFile（Go 1.16+ 推荐前者）读全内容 - 结构体字段必须导出（首字母大写），且带上
yaml:"field_name"tag；不加 tag 默认按字段名小写匹配，但易受重命名影响 - 若 YAML 含多个文档（如 kubectl apply -f 中常见），需用
yaml.Decoder配合Decode循环调用，不能一次Unmarshal
解析多文档 YAML（如 kubectl apply 的复合清单）必须用 yaml.Decoder
一个 YAML 文件里用 --- 分隔多个资源，yaml.Unmarshal 只处理第一个文档，其余静默丢弃——这是最容易踩的坑。
正确做法是创建 *yaml.Decoder，然后反复调用 Decode 直到返回 io.EOF：
file, _ := os.Open("manifests.yaml")
defer file.Close()
dec := yaml.NewDecoder(file)
for {
var obj interface{}
if err := dec.Decode(&obj); err == io.EOF {
break
} else if err != nil {
log.Fatal(err)
}
// 处理每个 obj，例如转成 runtime.Unstructured
}
- 每次
Decode会自动跳过---，无需手动切分 - 用
interface{}接收可避免提前定义结构体，适合泛化解析；若需强类型，可配合runtime.Scheme+UniversalDeserializer（client-go 场景） -
yaml.Decoder不缓存整个文件，内存友好，适合大文件
解析后想转成 client-go 的 runtime.Object？走 UniversalDeserializer
当你拿到原始 YAML 字节，又希望获得带类型信息、能被 client-go Create/Update 消费的对象时，不要自己写 switch 判断 kind —— 用 client-go 提供的 serializer.NewCodecFactory(scheme).UniversalDeserializer()。
- 先注册所有要用的 scheme（
corev1.AddToScheme、appsv1.AddToScheme等），否则反序列化会失败 -
UniversalDeserializer.Deserializer.ToObject返回runtime.Object和*schema.GroupVersionKind，后者可用于后续路由或校验 - 如果只关心元数据（labels、annotations、ownerReferences），可直接断言为
client.Object接口，不用管具体类型
sigs.k8s.io/yaml 不是 YAML 解析器，别误当主力用
这个包本质是“YAML → JSON → encoding/json”，只在一种场景下必要：你已有大量使用 json:"name,omitempty" tag 的 struct，并希望同一份 struct 同时支持 JSON API 输出和 YAML 配置输入。它不解决多文档、锚点、类型推导等 YAML 特有需求。
它对 nil slice/map 的处理和 v3 不一致，且内部依赖 gopkg.in/yaml.v2（已淘汰），在 Kubernetes client-go v0.25+ 中已被移除直接引用。
- 除非你在写一个既要输出 JSON API 又要读取 YAML 配置的通用服务，否则直接上
v3 - 它的
YAMLToJSON函数仅用于调试或中间转换，不是生产级 YAML 解析路径 - v3 已原生支持
omitempty、flow、inline等高级 tag，无需桥接
真正容易被忽略的是：YAML 中的 yes/no 在未指定字段类型时会被解析为字符串，而非布尔值；只有目标 struct 字段是 bool 类型，v3 才会尝试转换。这导致配置文件看似写了布尔值，实际运行时却因类型不匹配而静默失效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
