go的encoding/xml包解析xml时字段必须首字母大写并显式用xml:"tag"绑定,大小写与下划线须完全一致;属性加,attr;忽略字段用xml:"-";嵌套重复元素靠xml:"item"而非字段名;不支持命名空间、cdata和html实体,需预处理。

Go 的 encoding/xml 包能直接解析 XML,但结构体字段不导出、标签写错、嵌套层级没对齐,都会导致解析后字段全为空——不是报错,而是静默失败。
字段必须首字母大写 + 显式写 xml:"tag"
XML 标签名和 Go 字段名默认不自动转换。比如 <user_id>123</user_id> 对应的字段不能是 UserID int(不加 tag 就会去找 <userid></userid>),也不能是 user_id int(小写字段不可导出,xml 包根本看不到)。
- 所有待解析字段必须首字母大写,例如
UserID int - 必须用
xml:"user_id"显式绑定,大小写、下划线、连字符都要完全一致 - 属性要额外加
,attr,例如ID string `xml:"id,attr"`对应<item id="5"></item> - 忽略某个字段?写
xml:"-";想区分“缺失”和“空值”,用*string而非string
嵌套与重复元素:切片字段名不重要,xml:"item" 才是关键
encoding/xml 不按结构体字段名匹配子元素,而是严格按 xml: 标签里的字符串找 XML 子节点名。外层容器是否建 struct、要不要保留,取决于你是否关心它的属性或文本内容。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 多个
<item></item>直接用[]Item `xml:"item"`,不是`xml:"items"` - 如果 XML 是
<items><item>...</item></items>,且<items></items>有属性(如count="2"),那就得单独建 struct:Items ItemsContainer `xml:"items"` - 空列表(无
<item></item>)会得到[]Item{},不是nil;检查是否存在请用len(x.Items) == 0 - 别用
*[]Item,xml.Unmarshal不支持切片指针,会静默跳过
命名空间、CDATA、HTML 实体这些它基本不管
encoding/xml 不校验命名空间,也不展开 HTML 实体(如 ©)、不解析 CDATA 块。遇到 xmlns= 或 ,它要么跳过,要么把内容当普通文本塞进 chardata 字段里。
- 带
xmlns的 XML(如<rss xmlns="http://purl.org/rss/1.0/"></rss>),默认所有子元素都解析失败——因为包把它们归为“未知命名空间”。临时解法:用strings.ReplaceAll(xmlBytes, `xmlns="..."`, "")预处理 - 要保留原始 CDATA 内容?字段类型设为
[]byte并加xml:",chardata";想二次解析,得自己调xml.Unmarshal再跑一遍 -
、©这类在 XML 里非法(除非 DTD 声明),浏览器能容错,encoding/xml会直接报invalid character entity。先用xmllint --noout file.xml验证合法性
生成 XML 时中文乱码、没声明头、字段顺序不对
xml.Marshal 只输出纯 UTF-8 字节流,不带 XML 声明,也不缩进,字段序列化顺序就是结构体定义顺序。
- 加声明头:手动拼接
"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" + string(xmlBytes) - 要缩进:用
xml.MarshalIndent(v, "", " "),第二个参数是父元素前缀(通常传空字符串),第三个是每级缩进符 - 字段顺序无法靠 tag 控制,别写
xml:"1,title"——encoding/xml不支持序号语法 - 零值字段(
0、""、nil)默认仍输出;跳过它们,加xml:",omitempty"(注意:这仅影响 Marshal,不影响 Unmarshal)
最易被忽略的是:字段未导出时,无论标签写得多准,xml.Unmarshal 都不会碰它——连错误都不报,就默默填零值。调试时先打个 fmt.Printf("%+v", yourStruct),看是不是连 XMLName 都没填上。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










