Go语言使用结构体Tag解析XML数据示例

Owen

发布时间：2026-10-13| 5人浏览过

原创

本文介绍了如何在Go语言中高效解析XML数据。通过结合 encoding/xml 包与结构体标签（struct tags），开发者可以轻松实现XML到Go结构体的自动映射，无需编写复杂的逐节点解析逻辑。

结果与目标

目标是将外部XML文件（如地理位置列表）读取并转换为Go程序中可操作的结构体对象，进而遍历或处理其中的数据。相比其他语言需要额外的库或复杂的DOM/SAX解析流程，Go的方式更简洁且类型安全。

准备条件

本地安装 Go 语言环境（版本不限，标准库支持即可）。
一个待解析的 XML 源文件，确保其格式规范且包含预期的层级结构。
了解 Go 基础语法及结构体定义方法。

真实操作顺序

第1步：定义匹配XML结构的Go结构体

目的：建立XML元素与Go字段的映射关系。核心在于使用反引号包裹的 struct tag 指定字段在XML中的对应方式。

动作：

根据XML顶层元素创建根结构体，字段名需首字母大写以导出。
对于重复出现的节点（如国家、州、城市），使用切片类型（slice）。若为单一节点可直接使用基本类型。
利用 xml: 标签声明属性或文本内容：

xml:"名称"：表示子元素名为“名称”。
xml:",attr"：表示当前元素的属性。
xml:",chardata"：表示文本内容（本例未使用，但需注意区分）。

type Location struct {
    CountryRegion []CountryRegion `xml:"CountryRegion"`
}

type CountryRegion struct {
    Name  string     `xml:",attr"`
    Code  string     `xml:",attr"`
    State []State    `xml:"State"`
}

type State struct {
    Name string  `xml:",attr"`
    Code string  `xml:",attr"`
    City []City  `xml:"City"`
}

type City struct {
    Name   string    `xml:",attr"`
    Code   string    `xml:",attr"`
    Region []Region  `xml:"Region"`
}

type Region struct {
    Name string `xml:",attr"`
    Code string `xml:",attr"`
}

注意：如果XML层级名称与Go字段名不一致，可在 tag 中显式写出 XML 标签名，例如 xml:"GeographicArea"。

第2步：读取XML文件内容

目的：获取用于反序列化的原始字节数据。

入口：os 和 io/ioutil（注：新版Go推荐使用 os.ReadFile 替代 ioutil.ReadAll，此处保留原逻辑兼容性说明）。

动作：

package main

import (
	"fmt"
	"os"
	"encoding/xml"
	"io/ioutil"
)

打开文件并读取所有字节：

f, err := os.Open("LocList.xml")
if err != nil {
	panic(err)
}
defer f.Close() // 最佳实践：关闭文件句柄

data, err := ioutil.ReadAll(f)
if err != nil {
	panic(err)
}

第3步：执行XML解析并映射数据

目的：将字节数据转换为强类型的Go结构体实例。

动作：使用 xml.Unmarshal 函数。

var v Location
err = xml.Unmarshal(data, &v)
if err != nil {
	panic(err)
}

此时 v 变量即包含了完整的XML树结构数据，可通过标准Go代码访问。

第4步：遍历与应用数据

目的：验证解析结果并进行后续业务处理。

动作：使用循环结构遍历嵌套切片。

for _, cr := range v.CountryRegion {
    if len(cr.State) == 0 {
        continue
    }
    for _, st := range cr.State {
        if len(st.City) == 0 {
            continue
        }
        for _, ct := range st.City {
            if len(ct.Region) == 0 {
                continue
            }
            for _, rg := range ct.Region {
                fmt.Printf("%s,%s,%s,%s,%s\n", 
                    cr.Code, st.Code, ct.Code, rg.Code, rg.Name)
            }
        }
    }
}