Go encoding/xml 如何映射重复子节点到切片

接第三方 XML 时，最容易卡住的地方不是调用 xml.Unmarshal，而是一个父节点下面有多个同名子节点：如果结构体只写一个字段，后续数据就无法按条目保存。Go 的做法很直接：把重复元素对应的字段声明为切片，并用 xml:"item" 指定元素名；每遇到一个匹配的 ，encoding/xml 就向切片追加一个元素。

官方文档：https://pkg.go.dev/encoding/xml

重复 为什么会自然进入 []Item

假设 XML 是一个目录，catalog 下有多个 item，每个条目还有属性、名称和多个标签。结构体字段应该描述“一个条目长什么样”，父结构体再用切片表达“有多少个条目”。这里的字段必须导出，否则反射无法写入。

package main

import (
    "encoding/xml"
    "fmt"
    "log"
)

type Catalog struct {
    XMLName xml.Name `xml:"catalog"` // 记录根节点名称，便于确认输入层级
    Items   []Item   `xml:"item"`    // 同名 item 会逐个追加到切片
}

type Item struct {
    ID   string   `xml:"id,attr"` // 从 item 属性读取稳定标识
    Name string   `xml:"name"`    // 读取一个名称子节点
    Tags []string `xml:"tag"`     // 一个 item 内的重复 tag 也映射为切片
}

func main() {
    data := `键盘办公USB显示器办公`

    var catalog Catalog
    if err := xml.Unmarshal([]byte(data), &catalog); err != nil {
        log.Fatal(err) // 解码失败就停止，避免继续使用不完整结果
    }
    fmt.Println(len(catalog.Items), catalog.Items[0].Tags)
}

这个映射有两层切片关系：外层 Items 对应多个 item，内层 Tags 对应同一个条目里的多个 tag。标签值按名称匹配，大小写不一致就不会自动当成同一个元素。属性则使用 ,attr，不能和普通子节点写法混用。

用 xml 标签处理嵌套层级

实际接口常把数据再包一层，例如 ... 。这时不要为了迁就 XML 额外创建一堆只使用一次的中间结构，可以在切片字段上用 > 描述从当前元素向下查找的路径：

type Feed struct {
    Items []Item `xml:"payload>items>item"` // 沿固定层级找到所有 item
}

// 只保留业务真正需要的字段，包装节点由标签路径表达
type Item struct {
    ID   string `xml:"id,attr"`
    Name string `xml:"name"`
}

这里的关键不是把标签写得越长越好，而是先对照 XML 确认每一层名称。payload>items>item 表示从 Feed 当前节点开始，依次经过三个名称，最后把每个 item 解码成一个 Item。如果服务端把 items 改成 records，旧标签不会“猜测”新名称，结果就可能保持为空。

缺失节点、空值和复用对象怎么区分

重复节点不存在时，切片通常保持 nil，而出现节点但文本为空时，元素可能存在但内容是空字符串。业务只关心“有没有可展示条目”时，检查 len(items) == 0 就够了；业务需要区分“字段没返回”和“返回了空集合”时，不能只依赖普通切片，应该让包装节点使用指针，或为自定义类型实现 UnmarshalXML。

另一个常见坑是复用目标对象。解码前先创建新的 Feed，或者明确把旧切片置空，避免上一次请求的条目和本次结果混在一起。不要把“这次 XML 没有 item”误判成“接口返回了上次的条目”。

让解码结果可检查

排查时可以先打印 len(Items) 和每个条目的关键标识，再判断是路径没有匹配，还是子节点本身为空。对外部 XML，Unmarshal 返回错误时应保留错误上下文；未知但格式正确的元素可能被忽略，所以“没有报错”不等于“所有字段都成功映射”。

相关问题

XML 只有一个子节点，还需要切片吗？

如果协议未来可能返回多个同名节点，建议仍使用切片；如果业务模型明确只允许一个，才使用单值字段，并把重复输入视为需要额外处理的协议问题。

字段名和 XML 标签大小写不同怎么办？

显式写 xml:"真实名称"，不要依赖字段名推断。encoding/xml 的匹配区分大小写，导出字段才有机会被赋值。

怎么区分缺失节点和空节点？

先区分包装节点是否存在，再看切片长度和元素内容；需要保留存在性时，用指针包装结构或自定义 UnmarshalXML 记录状态。