在Go语言的标准库中，encoding/xml包提供了结构体与XML互相转换的能力，而结构体tag是控制转换过程中字段映射规则的关键配置。通过合理定义结构体tag，我们可以指定XML元素的名称、属性、嵌套关系等，让转换结果完全符合业务需求。
基础字段映射规则
最基础的XML tag定义格式为xml:"字段名"，用于指定结构体字段对应的XML元素名称。如果不定义该tag，默认会使用结构体字段的原名作为XML元素名，且首字母会被转为小写。
示例代码如下：
package main
import (
"encoding/xml"
"fmt"
)
// 定义用户结构体
type User struct {
Name string `xml:"name"` // 映射为XML的name元素
Age int `xml:"age"` // 映射为XML的age元素
}
func main() {
user := User{Name: "张三", Age: 25}
// 结构体转XML
data, err := xml.Marshal(user)
if err != nil {
fmt.Println("转换失败:", err)
return
}
fmt.Println(string(data))
}
上述代码运行后输出的XML内容为<User><name>张三</name><age>25</age></User>，可以看到结构体字段通过tag映射为了对应的XML元素。
定义XML属性
如果希望结构体字段对应XML元素的属性而非子元素，可以在tag中添加,attr后缀，格式为xml:"属性名,attr"。
package main
import (
"encoding/xml"
"fmt"
)
type Product struct {
ID int `xml:"id,attr"` // 映射为XML元素的id属性
Name string `xml:"name"`
Price float64 `xml:"price"`
}
func main() {
product := Product{ID: 1001, Name: "笔记本电脑", Price: 4999.00}
data, err := xml.Marshal(product)
if err != nil {
fmt.Println("转换失败:", err)
return
}
fmt.Println(string(data))
}
运行后输出的XML为<Product id="1001"><name>笔记本电脑</name><price>4999</price></Product>，ID字段成为了Product元素的属性。
处理嵌套结构体
当结构体包含嵌套结构体时，默认情况下嵌套结构体的字段会被展开为外层XML元素的子元素。如果需要将嵌套结构体映射为一个独立的子元素，可以给嵌套结构体字段添加tag指定子元素名称。
package main
import (
"encoding/xml"
"fmt"
)
// 地址结构体
type Address struct {
Province string `xml:"province"`
City string `xml:"city"`
}
// 员工结构体
type Employee struct {
Name string `xml:"name"`
Addr Address `xml:"address"` // 嵌套结构体映射为address子元素
}
func main() {
emp := Employee{
Name: "李四",
Addr: Address{
Province: "广东",
City: "深圳",
},
}
data, err := xml.Marshal(emp)
if err != nil {
fmt.Println("转换失败:", err)
return
}
fmt.Println(string(data))
}
输出结果为<Employee><name>李四</name><address><province>广东</province><city>深圳</city></address></Employee>，嵌套的Address结构体被包装成了address子元素。
常用特殊tag配置
除了基础的字段名和attr配置，XML tag还支持多个特殊配置项，常见的如下：
omitempty：当字段值为零值时，不生成对应的XML元素或属性innerxml：字段内容会直接作为XML原始内容输出，不做转义处理comment：字段内容会作为XML注释输出any：可以匹配任意未定义的其他XML元素
以下是omitempty的使用示例：
package main
import (
"encoding/xml"
"fmt"
)
type Student struct {
Name string `xml:"name"`
Score int `xml:"score,omitempty"` // 分数为0时不生成该元素
Class string `xml:"class,omitempty"`
}
func main() {
// 分数为0，Class为空字符串
stu1 := Student{Name: "王五", Score: 0, Class: ""}
data1, _ := xml.Marshal(stu1)
fmt.Println("stu1 XML:", string(data1))
// 分数和班级都有值
stu2 := Student{Name: "赵六", Score: 90, Class: "三年级一班"}
data2, _ := xml.Marshal(stu2)
fmt.Println("stu2 XML:", string(data2))
}
stu1的输出结果为<Student><name>王五</name></Student>，Score和Class字段因为为零值且配置了omitempty，没有生成对应的XML元素。stu2的输出则包含完整的字段内容。
命名空间配置
如果XML需要包含命名空间，可以在tag中通过xmlns:前缀="命名空间地址"的方式定义，或者在元素名前添加命名空间前缀。
package main
import (
"encoding/xml"
"fmt"
)
type Book struct {
XMLName xml.Name `xml:"bk:book"` // 指定元素前缀和命名空间
Title string `xml:"bk:title"`
Author string `xml:"bk:author"`
}
func main() {
book := Book{Title: "Go语言入门", Author: "小明"}
// 定义命名空间
data, err := xml.Marshal(book)
if err != nil {
fmt.Println("转换失败:", err)
return
}
fmt.Println(string(data))
}
输出的XML会包含对应的命名空间信息，符合带命名空间的XML格式要求。