go的encoding/xml包解析xml需字段首字母大写并显式用xml:"tag"绑定，大小写与下划线须完全一致；属性加,attr；忽略字段用xml:"-";嵌套重复元素靠xml:"item"而非字段名；不支持命名空间、cdata和html实体，需预处理。
Go 的 encoding/xml 不是“开箱即用”的 XML 工具，而是严格依赖结构体定义与标签对齐的契约式解析器；字段不导出、标签写错、命名空间没处理，都会静默失败——不是报错，而是字段全为零值。
xml.Unmarshal 返回空结构体但不报错
这是最常踩的坑：调用 xml.Unmarshal 返回 nil 错误，但结构体里所有字段都是零值（""、0、nil）。根本原因不是 XML 语法错，而是 Go 结构体和 XML 树之间“没签好合同”。
- 字段必须首字母大写（导出），小写字段如
name string永远不会被填充 - XML 中的
<user-id>123</user-id>不能靠UserID string自动匹配，必须显式写UserID string `xml:"user-id"` - 属性要用
xml:",attr"，且字段类型只能是基础类型（string、int等），不能是结构体 - 嵌套元素必须用嵌套结构体，不能用
string接收含子节点的整段 XML；否则子内容直接被丢弃 - XML 命名空间（如
<rss xmlns="http://purl.org/rss/1.0/"></rss>）会让默认解析器跳过全部子元素——它不报错，只当没看见
生成 XML 时中文乱码、没声明头、缩进混乱
xml.Marshal 只输出 UTF-8 字节流，不带任何格式包装。接收方如果校验严格或运行在 Windows 上，大概率显示乱码或直接拒收。
- XML 声明必须手动拼：用
xml.Header + string(data)，其中xml.Header是"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" - 缩进要用
xml.MarshalIndent(v, "", " ")，第二个参数是父元素前缀（通常传空字符串），第三个是每级缩进符 - 字段顺序就是结构体定义顺序，无法靠 tag 控制；想按特定顺序输出，就得调整字段声明顺序
- 零值字段（如空字符串、0）默认仍会输出；加
xml:",omitempty"才能跳过 - 中文本身没问题，但若原始 XML 含非法字符实体（如
©少了分号），xml.Marshal不会修复，下游解析器会报invalid character entity
解析大 XML 文件内存暴涨甚至 OOM
xml.Unmarshal 是全量加载模式：先把整个 XML 读进内存，再反序列化。几十 MB 的文件就可能吃光 GB 级内存，这不是 bug，是设计定位决定的——它面向已知结构、规模可控的场景。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 改用
xml.NewDecoder流式解析：逐个调用decoder.Token()获取xml.StartElement、xml.CharData等事件，边读边处理 - 遇到不需要的深层嵌套，用
decoder.Skip()跳过，避免构造无用结构体 -
decoder.Token()返回nil表示 EOF，返回非nil错误才需处理；不检查返回值会导致 panic - 别在循环里反复 new 结构体再
xml.Unmarshal子片段——这等于把流式优势全抵消，还多分配内存 - 对不可信输入，先用
io.LimitReader限制最大读取字节数，防恶意超大文件
处理混合内容、动态节点和命名空间
标准库对复杂 XML 支持有限：xml:",any" 在 Go 1.22+ 已移除；CDATA、HTML 实体、注释默认不解析；命名空间不支持自动剥离或通配。
- 混合内容（如
<p>Hello <b>world</b>.</p>）需用[]interface{}+ 类型断言：遍历每个 token，判断是xml.CharData还是具体结构体 - 动态节点名（如插件配置里任意 key）不适合用固定 struct，应改用
map[string]string配合自定义UnmarshalXML方法，或直接走xml.Decoder.Token()手动解析 - 命名空间必须显式声明：XML 是
<rss xmlns="http://purl.org/rss/1.0/"></rss>，结构体就得写Title string `xml:"http://purl.org/rss/1.0/ title"` - CDATA 块里的内容会被当作普通文本解析，但其中的
、<code>&不会自动转义；若需保留原样，得用xml:",innerxml"（注意：它会包含子标签，不是纯文本） - HTML 片段混入 XML 是高频雷区：
"、'在 XML 里非法，必须提前转义或用strings.ReplaceAll修补
真正难的从来不是“怎么写”，而是“为什么没写进去”——encoding/xml 的静默失败机制，让问题藏在结构体标签的毫厘之间；一个下划线、一个空格、一个没导出的字段，都足以让整棵树消失不见。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
