如何使用 Go 的 encoding/xml 包解析带属性的嵌套 XML 文档-Golang-PHP中文网

如何使用 Go 的 encoding/xml 包解析带属性的嵌套 XML 文档

本文详解如何用 Go 标准库 encoding/xml 解析含属性、多变子元素的 XML 结构，通过结构体标签精准映射字段与 XML 节点/属性，并处理混合内容（如 0 和），实现键名、整数值与布尔值的可靠提取。

本文详解如何用 go 标准库 `encoding/xml` 解析含属性、多变子元素的 xml 结构，通过结构体标签精准映射字段与 xml 节点/属性，并处理混合内容（如 `0` 和 ``），实现键名、整数值与布尔值的可靠提取。

在 Go 中解析 XML 并非仅靠正则或字符串操作，而是依赖 encoding/xml 包的结构化反序列化能力。核心在于准确建模 XML 层级与语义：每个 XML 元素需对应一个 Go 结构体，属性用 ,attr 标签声明，文本内容用 ,chardata，子元素则通过嵌套字段和结构体标签指定路径。

以下是一个典型场景：给定如下 XML：

<?xml version="1.0"?><venue><c><a n="k1"><i>0</i></a>
    <a n="k2"><b v="f"></b></a>
  </c></venue>

目标是提取：

k1 对应的整数值 0
k2 对应的布尔值 false（注意：XML 中 "f" 会被 xml.Unmarshal 自动识别为 false）

✅ 推荐结构体建模（含指针优化）

为清晰区分不同 <a></a> 元素所含的实际子元素（ 或 ），推荐将可选子结构体字段声明为指针，未出现的字段将为 nil，便于逻辑判断：

type Venue struct {
    As []A `xml:"c>a"` // 匹配 <c> 下所有 <a> 元素
}

type A struct {
    N string `xml:"n,attr"` // 属性 n，如 "k1", "k2"
    I *I     `xml:"i"`      // 可选子元素 <i>
    B *B     `xml:"b"`      // 可选子元素 <b>
}

type I struct {
    Value int `xml:",chardata"` // <i> 的文本内容，如 "0"
}

type B struct {
    V bool `xml:"v,attr"` // <b> 的属性 v，如 "f" → false
}</b></i></b></i></a></c>

? 完整解析示例

package main

import (
    "encoding/xml"
    "fmt"
)

func main() {
    const data = `<?xml version="1.0"?><venue><c><a n="k1"><i>0</i></a>
    <a n="k2"><b v="f"></b></a>
</c></venue>`

    var venue Venue
    err := xml.Unmarshal([]byte(data), &venue)
    if err != nil {
        panic(err)
    }

    for _, a := range venue.As {
        switch {
        case a.I != nil:
            fmt.Printf("Key: %s, Type: int, Value: %d\n", a.N, a.I.Value)
        case a.B != nil:
            fmt.Printf("Key: %s, Type: bool, Value: %t\n", a.N, a.B.V)
        }
    }
}

输出：

Key: k1, Type: int, Value: 0
Key: k2, Type: bool, Value: false

⚠️ 注意事项与最佳实践

布尔属性兼容性：encoding/xml 支持 "true"/"false"、"1"/"0"、"t"/"f" 等常见布尔字符串表示；但不支持 "on"/"off" 或空字符串，建议在 XML 中统一使用标准格式。
字段可见性：所有参与 XML 解析的结构体及字段必须是导出的（首字母大写），否则 Unmarshal 将忽略。
空白与换行：XML 中的缩进与换行会被自动忽略，无需额外清洗。
错误处理：始终检查 xml.Unmarshal 返回的 err；若结构体字段类型与 XML 内容不匹配（如 abc 尝试解析为 int），会返回解析错误。
性能提示：对大规模 XML，可结合 xml.Decoder 流式解析以降低内存占用，但本例中 Unmarshal 已足够简洁高效。