go 的 encoding/xml 包支持通过 xmlname xml.name 字段显式声明结构体对应的 xml 根标签，避免因嵌套层级不匹配导致解析为空；直接在结构体字段上使用 xml:"tagname" 无法自动匹配外层根节点，需结合 xmlname 和结构体嵌套关系正确定义。
go 的 encoding/xml 包支持通过 xmlname xml.name 字段显式声明结构体对应的 xml 根标签，避免因嵌套层级不匹配导致解析为空；直接在结构体字段上使用 xml:"tagname" 无法自动匹配外层根节点，需结合 xmlname 和结构体嵌套关系正确定义。
在 Go 中解析 XML 时，顶层标签（即 root element，如
正确的做法是：为表示根元素的结构体添加 XMLName xml.Name 字段，并设置其标签名。这不仅让结构体“自知”其 XML 身份，还使嵌套解析逻辑清晰可靠。
以下是修复后的完整示例：
package main
import (
"encoding/xml"
"fmt"
"log"
)
const data = `
<people><person><id>46</id><name>John Smith</name></person><person><id>3007</id><name>Joe Smith</name></person></people>
`
type Person struct {
Id int `xml:"id"`
Name string `xml:"name"`
}
// ✅ 正确：People 显式声明自己对应 <people> 标签
type People struct {
XMLName xml.Name `xml:"people"` // ← 关键：绑定根标签
PersonList []Person `xml:"person"` // 子元素映射不变
}
func main() {
// 方式一：直接解析为 People（推荐）
var people People
if err := xml.Unmarshal([]byte(data), &people); err != nil {
log.Fatal("Unmarshal to People failed:", err)
}
fmt.Printf("People: %+v\n", people) // 输出包含两个 person 的切片
// 方式二：若需保留 Response 封装层，也需确保嵌套结构语义完整
type Response struct {
PeopleItem People `xml:",any"` // 或更安全地：`xml:"people"` + People 内部已有 XMLName
}
var response Response
if err := xml.Unmarshal([]byte(data), &response); err != nil {
log.Fatal("Unmarshal to Response failed:", err)
}
fmt.Printf("Response: %+v\n", response)
}</people>
⚠️ 注意事项：
- XMLName xml.Name 字段必须命名为 XMLName（固定名），且类型为 xml.Name；
- xml:"people" 标签应写在 XMLName 字段上，而非结构体定义处；
- 若使用嵌套结构（如 Response），内层结构（People）仍需自行声明 XMLName，外层字段可使用 xml:",any" 或省略标签（依赖内层自描述），避免双重标签冲突；
- 不要依赖 xml:"people" 在非 XMLName 字段上“提升”根匹配能力——它仅用于匹配该字段所代表的子元素，而非整个输入文档的根。
总结：Go 的 XML 解析是“结构驱动”的，而非“文档驱动”。要准确捕获顶层标签，必须让对应结构体通过 XMLName “认领”该标签。这是设计上的明确约定，而非隐式行为。掌握这一机制，即可稳健处理任意层级的 XML 数据结构。
