Go 的 XML 解析必须预先定义带正确 xml tag 的大写结构体,不支持动态解析;需注意编码转换、命名空间、DTD 处理、字段类型匹配及切片初始化;复杂场景应使用 xml.Token 手动解析。

XML 解析前必须定义结构体并正确打标签
Go 的 encoding/xml 不支持动态解析,所有字段必须提前声明为结构体字段,并用 xml tag 显式指定映射关系。漏打、打错、大小写不一致都会导致字段为空。
-
xml:"name"匹配同名 XML 元素;xml:"name,attr"匹配属性;xml:",chardata"捕获文本内容 - 嵌套元素需对应嵌套结构体,或用
xml:",any"接收未知子节点(但会丢失类型信息) - 首字母小写的字段默认被忽略(Go 可导出规则),务必大写开头
- 如果 XML 有命名空间(如
),结构体字段需用xml:"rss xmlns,attr"或整体用xml.Name字段捕获
Unmarshal 时常见空值或 panic 场景
xml.Unmarshal 失败通常不 panic,而是静默跳过不匹配字段或返回 nil 错误但数据不全。典型表现是结构体字段全为零值,却没报错。
- 输入 XML 是 UTF-8 以外编码(如 GBK)会导致解析失败且无明确提示——必须先转成 UTF-8 再传入
bytes.NewReader - XML 中存在 DTD 声明(
..>)会触发xml: invalid character entity错误——用strings.ReplaceAll(xmlStr, ", "










