XML与Go struct字段映射需显式用xml tag声明，如UserName string xml:"user_name"`；导出字段、命名空间、编码、CDATA及HTML实体需特别处理。
XML结构和Go struct字段名不匹配，解析结果为空
Go的encoding/xml默认按字段名（首字母大写）映射XML标签名，但大小写、下划线、连字符都不自动转换。比如XML里是<user_name>，而struct字段叫UserName，默认不会绑定——它会去找<UserName>。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
xmlstruct tag显式声明映射，例如：UserName string `xml:"user_name"` - 所有要参与反序列化的字段必须是导出字段（首字母大写）
- 忽略某个字段？加
xml:"-"`；可选字段？用指针类型（如*string），空标签或缺失时值为nil - 注意：XML注释、处理指令、CDATA内容不会被解析进struct，也不报错，容易误以为“漏数据”
嵌套结构、重复元素（如列表）怎么正确建模
XML里常见<items><item>...</item><item>...</item></items>这类模式，直接用[]Item能工作，但容易踩两个坑：一是没加xml:"item"导致解析失败，二是忘了外层容器标签是否需要单独建struct。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 重复子元素统一用切片，tag里写子元素名，例如：
Items []Item `xml:"item"`（对应多个<item>） - 如果外层有包裹标签（如
<items>），且你关心它的属性，就单独建struct；否则可省略，直接用切片+内嵌tag - 空列表（无
<item>）会得到长度为0的切片，不是nil；想区分“无节点”和“空节点”，得用*[]Item并检查是否为nil - 属性要用
attr后缀，例如：ID string `xml:"id,attr"`
解析含命名空间的XML经常panic或字段全空
带命名空间的XML（如<rss xmlns="http://purl.org/rss/1.0/">）会让encoding/xml默认忽略所有子元素——它把整个文档当成了“未知命名空间”，而Go的解析器不支持通配或自动剥离。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 要么预处理XML，用正则或
strings.ReplaceAll删掉xmlns=...（仅限可信、格式固定的数据） - 要么在struct tag里显式写全命名空间URI，例如：
Title string `xml:"http://purl.org/rss/1.0/ title"` - 更稳妥的做法：用
xml.Decoder配合Token()手动遍历，跳过命名空间校验（适合复杂/混合命名空间场景） - 错误现象典型：
xml: encoding/hex: invalid byte或静默失败（字段零值）——大概率是命名空间没对上
遇到特殊字符、CDATA、HTML实体时解析失败或乱码
encoding/xml本身不处理HTML实体（如 ）或CDATA块里的转义，它只做XML标准解析。如果源数据混了HTML片段，或用了非UTF-8编码（如GBK），就会出问题。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保输入是UTF-8编码；如果不是，先用
golang.org/x/text/encoding转码，再喂给xml.Unmarshal - CDATA内容会被原样当字符串读取（不含
<![CDATA[...]]>外壳），但内部的<、&等不会被二次转义——所以不用额外解码 - HTML实体（
）不会自动转成<code><，需自己调用html.UnescapeString() - 如果XML里有非法字符（如控制符U+0000），
xml.Unmarshal会直接返回invalid character错误，建议前置过滤
命名空间和编码问题最常被忽略，尤其当XML来自第三方API或老旧系统时，看似解析成功，实际关键字段为空——建议先用xml.Unmarshal试跑，再立刻打印err和reflect.ValueOf(v).NumField()确认字段是否真被赋值。
