17370845950

xml.Unmarshal要求字段名与XML标签严格大小写匹配，需用xml tag显式声明；嵌套结构中子元素名须与字段xml tag一致且字段类型为结构体或指针；推荐每层XML元素定义独立结构体并精确绑定tag。

xml.Unmarshal 要求字段名与 XML 标签名严格匹配（大小写敏感）

Go 的 xml.Unmarshal 不会自动将 snake_case XML 标签映射到 CamelCase 结构体字段，必须显式用 xml tag 声明。嵌套结构的关键是：子元素名必须与结构体字段的 xml tag 一致，且该字段类型需为结构体或指针。

• XML 中的 Alice30，对应结构体里 Profile 字段的 tag 必须是 xml:"profile"，不能是 xml:"Profile"
• 如果子元素可能缺失，建议用指针类型（如 *Profile），避免零值覆盖语义
• 匿名嵌套字段（内嵌结构体）默认会“提升”子标签，不推荐用于明确层级关系的 XML

多层嵌套时，每个层级都要定义独立结构体并配好 xml tag

XML 层级越深，结构体嵌套越明确——不要试图用单层结构体 + 复杂 tag 解析多层嵌套。每层 XML 元素都应有对应的 Go 结构体，并通过字段 tag 精确绑定。

type User struct {
    XMLName xml.Name `xml:"user"`
    Name    string   `xml:"name"`
    Profile Profile  `xml:"profile"` // ← 这里必须写 "profile"，不是 "Profile" 或 "PROFILE"
}

type Profile struct {
    XMLName xml.Name `xml:"profile"`
    Age     int      `xml:"age"`
    City    string   `xml:"city"`
}

• 忽略 XMLName 字段会导致外层标签名丢失，但不影响解析；加上它可保留原始标签信息
• 若 XML 中 下还有 ...，就再加一个 Address Address `xml:"address"` 字段和对应结构体
• 切忌把 Profile 定义成 map[string]interface{}：虽然能解析，但失去类型安全和字段可读性

遇到同名多实例（如 出现多次）必须用切片

XML 中重复出现的同名子元素（如多个 ），必须用 []Item 类型字段接收，否则只有最后一个会被保留。

type Order struct {
    XMLName xml.Name `xml:"order"`
    Items   []Item   `xml:"item"` // ← 关键：必须是切片
}

type Item struct {
    ID    string `xml:"id"`
    Name  string `xml:"name"`
    Price int    `xml:"price"`
}

• 如果误写成 Item Item `xml:"item"`（非切片），xml.Unmarshal 会静默覆盖，只存最后一个
• 空切片（[]Item(nil)）和空数组（[]Item{}）在反序列化时行为一致，都能正常追加；但前者更符合 Go 惯例
• 若某层嵌套中既有单个元素又有多个同名元素（比如
  只有一个，但 有多个），它们必须是不同字段，不可混用

属性（attribute）和文本内容（chardata）要显式声明，否则被忽略

XML 属性（如 ）和纯文本内容（如 Alice 中的 Alice）不会自动填充到任意字段，必须用 xml:",attr" 或 xml:",chardata" 显式标注。

type User struct {
    XMLName xml.Name `xml:"user"`
    ID      string   `xml:"id,attr"`     // ← 属性
    Name    string   `xml:"name"`        // ← 子元素文本
    Remark  string   `xml:"remark,attr"` // ← 另一个属性
    Content string   `xml:",chardata"`   // ← 如果  直接包含文本，比如 hello
}

• 未标注 ,attr 的字段绝不会读取属性值，哪怕字段名碰巧一样（如 ID string `xml:"id"` 不会读取 id="123"）
• ,chardata 只捕获直接子文本，不递归合并所有后代文本；含子元素时，它只拿到元素开始前、结束后的纯文本
• 混合内容（既有属性、又有子元素、还有文本）的结构体字段命名需格外小心，避免歧义

嵌套 XML 解析真正麻烦的不是语法，而是标签名大小写、是否带命名空间、空元素处理、以及属性与子元素的边界——这些细节一旦错一个 tag，xml.Unmarshal 就静默失败，连错误提示都不给。