在Go语言中处理XML数据时，经常会遇到一种情况：某个XML元素既带有属性，又包含直接的文本子内容。如果只按照常规方式定义结构体，往往只能拿到其中一部分信息。借助标准库encoding/xml提供的结构体标签机制，我们可以在同一次解析过程中，把元素的文本内容和各个属性全部映射到Go结构体的不同字段上。
一、核心原理：struct tag的两种映射规则
encoding/xml在反序列化时，完全依赖结构体字段后面的xml tag来决定数据去向。对于元素的文本内容，只需要把tag写成元素名本身，例如xml:"amount"，那么该字段就会接收此节点内的字符数据。对于属性，则必须在名字前加一个逗号并写上attr，例如xml:"currency,attr"，这样字段绑定的是同元素上的currency属性而非子节点。
这两个规则可以作用于同一个结构体中的不同字段，因此它们天然支持“文本+属性”同时提取。需要留意的是，如果字段既不想对应文本也不想对应属性，而是对应子元素，则直接写子元素名即可；若字段类型是指针或切片，库会自动处理节点树的嵌套。理解这套映射逻辑，是写出正确解析代码的前提。
二、完整代码示例
下面用一个简单的订单金额节点来演示。假设XML片段中，amount元素拥有currency属性，并且内部文本是数值字符串。我们定义对应的结构体，并在main函数中完成解析。
package main
import (
"encoding/xml"
"fmt"
)
// Money 表示带币种的金额节点
type Money struct {
Currency string `xml:"currency,attr"`
Value string `xml:"amount"`
}
// Order 包含上述节点
type Order struct {
XMLName xml.Name `xml:"order"`
Total Money `xml:"total"`
}
func main() {
data := []byte(`<order><total currency="USD">19.99</total></order>`)
var o Order
err := xml.Unmarshal(data, &o)
if err != nil {
fmt.Println("解析失败:", err)
return
}
fmt.Printf("币种: %s, 金额: %sn", o.Total.Currency, o.Total.Value)
}
在上面代码中，Money结构体的Currency字段通过xml:"currency,attr"拿到了属性，Value字段通过xml:"amount"拿到了total元素的文本。运行后会输出“币种: USD, 金额: 19.99”，证明文本与属性已被同时提取。
如果XML中属性可能缺失，Go会把对应字段留空字符串；若文本节点为空，字段同样为空。可以在解析后做简单的校验，比如判断Currency是否为空来决定默认值。这种处理方式比手动遍历xml.Decoder的Token要简洁得多，也更容易维护。
三、常见误区与进阶处理
一个容易踩的坑是：把文本字段的tag误写成xml:",chardata"。虽然chardata也能拿文本，但它会忽略元素名匹配，在存在多个同名子元素时容易串数据。相比之下，直接写元素名更安全。另外，当元素包含混合内容（文本加子标签）时，文本会先被拼接赋给对应字段，复杂场景建议用xml:",innerxml"接住原始片段再二次解析。
面对带有命名空间的XML，属性或元素名前可能带前缀。此时tag里要写完整带前缀的名字，例如xml:"ns:currency,attr"。若不想关心前缀，可使用xml:"*,attr"匹配任意命名空间的同名属性，但同元素上不能有多个同名不同前缀的属性以免冲突。掌握这些细节，基本可以覆盖业务里绝大多数“文本+属性”的解析需求。
四、总结
Go语言解析XML并同时提取元素文本与属性，关键就在于合理利用struct tag的逗号语法。文本走元素名映射，属性走名字加attr映射，二者互不干扰。配合Unmarshal方法，数十行代码就能稳定处理常见报文。实际项目中建议把XML样例先格式化，再对照设计结构体，可大幅降低调试成本。
GoXML解析struct_tag修改时间：2026-08-06 16:48:25