Go的encoding/xml包解析XML时，结构体字段必须首字母大写且显式用xml:"tag"绑定，大小写、连字符、下划线须与XML元素名完全一致；小写字段被静默忽略，不报错但字段为空。
结构体字段必须大写且显式打标签
Go 的 encoding/xml 包不会读取小写字母开头的字段，也不会自动推断 XML 元素名——所有映射都靠 xml:"tag" 标签驱动。漏写、拼错、大小写不一致（比如 XML 是 <user-id>，结构体却写 xml:"userid"），都会导致字段为空，且不报错。
常见错误现象：Unmarshal 返回 nil 错误，但解析后结构体字段全是零值。
- 字段名必须首字母大写（导出）
-
xml:"tag"中的 tag 名需与 XML 实际元素名完全一致（含连字符、下划线） - 属性用
xml:"attrname,attr"，如xml:"id,attr"对应<item id="123"> - 文本内容用
xml:",chardata"，不能写成xml:"#text"或其他变体
嵌套层级要用 > 符号或指针结构体精准控制
XML 路径不是靠字段名推导，而是靠标签里的路径表达式。比如 <root><a><b>val</b></a></root>，想直接把 val 映射到字段，就得写 xml:"a>b"，而不是靠嵌套结构体硬套。
但如果嵌套是动态深度（如 OPML 的无限 <outline> 嵌套），就不能只靠路径表达式——必须用递归结构体 + 指针字段。
立即学习“go语言免费学习笔记（深入）”；
- 固定两层：用
xml:"parent>child"，例如Addresses []Address `xml:"addresses>address"` - 任意深度：子节点字段声明为
*Outline或[]*Outline，而非Outline或[]Outline - 切片字段名无关紧要，关键在标签；
xml:"outline"才匹配<outline>，不是靠字段名Outline
混合结构（字符串值 vs 子元素）必须分层建模
真实 XML 常出现同一标签名下有时是纯文本、有时是子元素的情况，比如 <value>abc</value> 和 <value><key>x</key><value>y</value></value>。Go 的 Unmarshal 无法自动多态，强行共用一个字段会失败。
核心解法是把语义拆开：顶层 value 字段存字符串，另设一个 Nested []NestedValue `xml:"value>value"` 提取嵌套路径。
- 不要试图用
interface{}或xml:",any"捕获后再判断类型——会丢失结构信息，且后续处理成本高 -
xml:"value>value"中的>表示跳过中间节点，直接定位到嵌套内部的value - 如果嵌套层级不确定，优先考虑
xml.Token流式解析，避免结构体爆炸
命名空间和 CDATA 需预处理或手动处理
encoding/xml 不原生支持命名空间（如 <rss xmlns="http://purl.org/rss/1.0/">）和 CDATA 内容。遇到这类 XML，要么提前剥离命名空间，要么用 xml.Name 字段捕获并手动比对。
CDATA 内容会被当作普通文本解析，但若其中含 HTML 实体（如 ），标准包不展开——需额外调用 html.UnescapeString 处理。
- 命名空间属性可用
xml:"xmlns,attr"单独提取，但无法用于元素匹配 - 含命名空间的元素（如
<dc:creator>）无法用xml:"dc:creator"直接映射，需先移除前缀或改用 Token 解析 - 大文件或含大量 CDATA 的场景，建议用
xml.Decoder配合Token迭代，避免一次性加载和重复解码
