Go嵌套结构体YAML自定义标签不生效，求解决方案

问题原因 #

出现该问题的核心原因是使用的YAML处理库无法识别你定义的yaml:标签，最常见的场景是导入了错误的YAML包，或是使用了不兼容的第三方YAML库，导致库忽略自定义标签，直接使用结构体字段名生成YAML。

注：你的代码中结构体字段均为首字母大写（已导出状态），不存在因字段未导出导致标签失效的情况。

解决方法 #

1. 导入正确的标准YAML库 #

Go官方未内置YAML处理能力，需使用社区维护的标准库gopkg.in/yaml.v2或gopkg.in/yaml.v3，二者均可正确识别yaml:标签。

导入示例：

// 使用v2版本
import "gopkg.in/yaml.v2"

// 或使用v3版本
import "gopkg.in/yaml.v3"

2. 修正结构体初始化的语法错误 #

你的代码中结构体初始化时，字段末尾缺少逗号，会导致编译失败，需补充逗号：

dummy1 := Dummy {
    Name: "a", // 补充逗号
    Type: "type a", // 补充逗号
    Params: DummyParams {
        Param1: "foo", // 补充逗号
        Param2: "bar", // 补充逗号
    }, // 补充逗号
}

3. 完整可运行示例 #

package main

import (
    "os"

    "gopkg.in/yaml.v2"
)

type DummyParams struct {
    Param1 string `yaml:"param1"`
    Param2 string `yaml:"param2"`
}

type Dummy struct {
    Name   string       `yaml:"name"`
    Type   string       `yaml:"type"`
    Params DummyParams `yaml:"params"`
}

func main() {
    dummies := make([]Dummy, 0)
    dummy1 := Dummy{
        Name: "a",
        Type: "type a",
        Params: DummyParams{
            Param1: "foo",
            Param2: "bar",
        },
    }
    dummies = append(dummies, dummy1)
    dummy2 := Dummy{
        Name: "b",
        Type: "type b",
        Params: DummyParams{
            Param1: "foo",
            Param2: "bar",
        },
    }
    dummies = append(dummies, dummy2)

    yamlData, err := yaml.Marshal(&dummies)
    if err != nil {
        panic(err)
    }
    writeErr := os.WriteFile("foo.yaml", yamlData, 0644)
    if writeErr != nil {
        panic(writeErr)
    }
}

运行后生成的foo.yaml会正确使用标签指定的小写名称：

- name: a
  type: type a
  params:
    param1: foo
    param2: bar
- name: b
  type: type b
  params:
    param1: foo
    param2: bar

内容的提问来源于stack exchange，提问作者J.g