Go encoding/xml 属性和子元素同名时怎么设计结构体

XML 里出现 A1 时，属性和子元素虽然都叫 code，但它们不是同一份数据。Go 的 encoding/xml 可以同时接收，关键是使用两个不同的字段名：属性写成 xml:"code,attr"，子元素写成 xml:"code"。不要让两个 Go 字段共用同一个字段名，也不要把属性标签误写成普通元素标签。

Go的标准库encoding/xml支持给同名下的不同字段分别加`attr`标签绑定属性、无attr的同名标签绑定子元素，两个字段互不干扰，序列化反序列化都能正常工作，不用额外手写解析逻辑。

同名 XML 应拆成两个 Go 字段

建议先把 XML 结构画成两个域：item 的属性域里有 code="A"，子元素域里有 A1。结构体字段可以这样写：

type Item struct {
    // XMLName 记录外层元素名称，便于确认当前结构对应 item。
    XMLName xml.Name `xml:"item"`
    // ,attr 表示读取 item 的属性，而不是读取子元素。
    CodeAttr string `xml:"code,attr"`
    // 没有模式标记时，code 表示 item 内的子元素。
    CodeElement string `xml:"code"`
}

这里的 Go 字段名故意不同，真正决定映射的是反引号里的标签。CodeAttr 只接收属性值 A，CodeElement 只接收子元素文本 A1。标签中的 ,attr 是边界，不能省略。

用 Unmarshal 判断两个值是否各走各的映射

读取时要传入结构体指针。字段未导出、标签写错或 XML 实际层级不同，都会让结果看起来像“同名冲突”。先用一个最小输入确认边界：

var got Item
data := []byte(`A1`)

// Unmarshal 会把属性和子元素分别填入两个字段。
if err := xml.Unmarshal(data, &got); err != nil {
    // 解析错误应直接返回，避免继续使用不完整结构体。
    return err
}
fmt.Println(got.CodeAttr, got.CodeElement)
// 预期：A A1

可以把这次映射记成一张速查表：

Marshal 与 Unmarshal 要遵守同一套标签边界

如果结构体同时用于输出 XML，仍然保留两个字段。xml.MarshalIndent 会把 CodeAttr 输出为属性，把 CodeElement 输出为子元素；字段名改成 Code 并不会让两个来源自动合并。

item := Item{
    // XMLName 决定最外层元素名。
    XMLName: xml.Name{Local: "item"},
    // 属性与子元素使用相同 XML 名称，但保存不同值。
    CodeAttr: "A",
    CodeElement: "A1",
}
out, err := xml.MarshalIndent(item, "", "  ")
if err != nil {
    // 输出失败时不要返回半成品 XML。
    return err
}
fmt.Println(string(out))

实际项目中，属性通常是标识或状态，子元素可能是正文或嵌套数据。两个 Go 字段分开后，后续新增 omitempty、切片或嵌套路径时，影响范围更容易判断。

遇到空值时按四项清单排查

第一，看字段是否大写导出；encoding/xml 通过反射赋值，未导出字段不会被填充。第二，看属性标签是否包含 ,attr。第三，看子元素是否真的直接位于当前结构体对应的 XML 节点下；如果多了一层 meta>code，应使用 xml:"meta>code"。第四，确认输入是单个子元素还是重复元素；重复节点应使用切片，而不是期待后一个值覆盖前一个值。

如果属性可能缺失，字符串字段会保持零值；这时要结合业务规则区分“没有属性”和“属性为空”。不要先把两个字段合并成一个字符串再解析，那会丢掉 XML 原本的结构信息。

相关问题

属性和子元素可以使用同一个 Go 字段吗？

不建议。一个字段只能稳定表达一种映射来源，拆成两个字段最直观，也便于 Marshal 反向生成。

为什么 XML 标签写对了还是空值？

优先检查字段是否导出、传入的是否是指针，以及 XML 层级是否与标签路径一致。

多个同名子元素怎么接收？

把子元素字段定义为切片，例如 Codes []string `xml:"code"`；属性仍单独使用 CodeAttr string `xml:"code,attr"`。