Go语言怎么用encoding/xml标准库解析XML？Golang解析XML完整教程

Go语言的标准库encoding/xml提供了完整的XML数据解析和生成能力，开发者可以通过结构体标签映射的方式快速将XML数据转换为Go结构体，也可以基于流式解码器处理大体积的XML文件，满足不同场景下的XML处理需求。

核心结构体标签说明

使用encoding/xml解析XML时，最常用的方式是通过结构体标签定义XML元素和结构体字段的映射关系，以下是常用的标签属性：

• xml:"element_name"：指定结构体字段对应XML中的子元素名称
• xml:"attr"：标记字段对应XML元素的属性
• xml:"chardata"：标记字段对应XML元素的字符数据
• xml:"innerxml"：标记字段保存对应XML元素的原始内容

基础解析示例：解析简单XML字符串

以下示例演示如何将一段简单的XML字符串解析为Go结构体：

package main

import (
	"encoding/xml"
	"fmt"
)

// 定义映射XML的结构体
type User struct {
	XMLName xml.Name `xml:"user"` // 对应根元素user
	ID      int      `xml:"id"`   // 对应子元素id
	Name    string   `xml:"name"` // 对应子元素name
	Age     int      `xml:"age"`  // 对应子元素age
}

func main() {
	// 待解析的XML字符串
	xmlStr := `<user><id>1</id><name>张三</name><age>25</age></user>`
	var user User
	// 执行解析
	err := xml.Unmarshal([]byte(xmlStr), &user)
	if err != nil {
		fmt.Println("解析失败:", err)
		return
	}
	fmt.Printf("解析结果: ID=%d, 名称=%s, 年龄=%dn", user.ID, user.Name, user.Age)
}

解析带属性的XML

如果XML元素包含属性，可以通过结构体标签的xml:"attr"标记来映射属性值：

package main

import (
	"encoding/xml"
	"fmt"
)

type Book struct {
	XMLName xml.Name `xml:"book"`
	// isbn属性映射到ISBN字段
	ISBN string `xml:"isbn,attr"`
	// 子元素title映射到Title字段
	Title string `xml:"title"`
	// 子元素author映射到Author字段
	Author string `xml:"author"`
}

func main() {
	xmlStr := `<book isbn="9787111111111"><title>Go语言编程</title><author>李四</author></book>`
	var book Book
	err := xml.Unmarshal([]byte(xmlStr), &book)
	if err != nil {
		fmt.Println("解析失败:", err)
		return
	}
	fmt.Printf("书籍信息: ISBN=%s, 书名=%s, 作者=%sn", book.ISBN, book.Title, book.Author)
}

使用流式解码器处理大XML文件

当XML文件体积较大时，使用xml.Unmarshal一次性加载全部内容会占用较多内存，此时可以使用xml.Decoder进行流式解析：

package main

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

// 定义单个条目的结构体
type Item struct {
	Name string `xml:"name"`
	Value string `xml:"value"`
}

func main() {
	// 模拟大XML内容
	xmlContent := `<items>
		<item><name>item1</name><value>100</value></item>
		<item><name>item2</name><value>200</value></item>
		<item><name>item3</name><value>300</value></item>
	</items>`
	decoder := xml.NewDecoder(strings.NewReader(xmlContent))
	// 循环解码每个元素
	for {
		t, err := decoder.Token()
		if err != nil {
			break
		}
		// 判断是否为开始元素
		if startElem, ok := t.(xml.StartElement); ok {
			if startElem.Name.Local == "item" {
				var item Item
				// 解码当前item元素到结构体
				err := decoder.DecodeElement(&item, &startElem)
				if err != nil {
					fmt.Println("解码元素失败:", err)
					continue
				}
				fmt.Printf("解析到条目: 名称=%s, 值=%sn", item.Name, item.Value)
			}
		}
	}
}

常见注意事项

• 结构体字段必须首字母大写才能被encoding/xml包访问到，否则无法完成映射
• XML标签名称区分大小写，结构体的标签名称和XML元素名称需要完全匹配
• 如果XML中有命名空间，可以在结构体标签中指定命名空间，例如xml:"ns:element_name"
• 解析失败时可以通过错误信息的提示定位问题，常见错误包括XML格式不合法、结构体标签定义错误等

Goencoding_xmlXML解析Golang修改时间：2026-06-27 05:24:30