如何使用Go语言xml2json库将XML文件转换为JSON格式？

本文共计1285个文字，预计阅读时间需要6分钟。

Go 标准库的 `xml.Unmarshal` 是处理 XML 转结构体最稳妥的方式，不是因为它高级，而是因为它不引入额外的解析逻辑、不改变字段映射规则、也不隐藏命名空间或 CDATA 的行为。相比之下，第三方库如 `xml2json` 大多先将 XML 转换为 map[string]interface{}，再进行一层 JSON 编码，这增加了抽象层次，容易在嵌套元素、重复标签、属性混合使用时出错。

常见错误现象：json.Marshal 输出空对象 {} 或字段全为 null，实际是 XML 结构没对齐 struct tag，或者用了 xml:",any" 却没处理子节点类型。

• 必须确保 struct 字段有 xml:"tagname" 或 xml:",attr" 显式声明，不能依赖字段名自动匹配（XML 不区分大小写，Go 字段是导出的才可被反射访问）
• 遇到 <item count="2">apple</item> 这类带属性+文本内容的，得用两个字段：Count string `xml:"count,attr"` 和 Text string `xml:",chardata"`
• 如果 XML 有命名空间（如 <rss xmlns="http://purl.org/rss/1.0/">），标准库默认忽略，需手动 strip 前缀或用 xml.Name.Space 判断

json.Marshal 输出字段全是小写？怎么保持 PascalCase

Go 的 json 包默认用字段名的小写形式作 key，但 XML 原始结构往往用大驼峰或中划线。这不是 bug，是设计使然：struct 字段必须导出（首字母大写），而 json tag 控制序列化名称。

使用场景：你希望 <UserName>Alice</UserName> 反序列化后，JSON 输出 {"UserName":"Alice"} 而不是 {"username":"Alice"}。

立即学习“go语言免费学习笔记（深入）”；

• 在 struct 字段加 json:"UserName" tag，和 xml:"UserName" 并存，互不干扰
• 别用 json:",string" 除非真要强制转字符串（比如数字字段想输出带引号的字符串），否则可能让前端解析失败
• 如果 XML 标签名含中划线（如 <first-name>），struct 字段名得是 FirstName，然后 tag 写 xml:"first-name" + json:"first_name"（下划线更符合 JSON 惯例）

遇到 invalid character ' 怎么定位

这个错误不是来自 XML 解析，而是你误把 XML 字节流直接喂给了 json.Unmarshal —— 它只认 JSON 格式，见到 < 当然崩溃。

典型错误链：io.ReadAll(xmlReader) → 得到 []byte → 直接传给 json.Unmarshal → 报错。

• 正确路径只有两条：XML → struct → JSON，或 XML → 自定义 map → JSON；不存在“XML 字节流一键转 JSON 字节流”的安全捷径
• 调试时先用 fmt.Printf("%s", data) 看前 100 字节，确认是不是真的 XML（以 <?xml 或 <root 开头）
• 如果上游给的是 HTTP response body，注意是否被 gzip 压缩过 —— gzip.NewReader(resp.Body) 忘了套，读出来就是乱码，再 marshal 也会崩

要不要用 github.com/bmizerany/xml2json 这类库

不推荐用于生产逻辑，仅适合临时脚本或调试查看。它的核心是把 XML 树硬塞进 map[string]interface{}，靠 key 名推断类型（比如 "@attr" 表示属性，"#text" 表示内容），但这种约定在真实 XML 中极不可靠：CDATA、注释、处理指令、混合内容都会破坏结构。

性能影响明显：一次解析触发多次内存分配，map 嵌套深了 GC 压力大；兼容性差：不支持 namespace，不处理 <![CDATA[...]]>，遇到 <tag/> 和 <tag></tag> 视为不同结构。

• 如果你只是想快速看 XML 对应的 JSON 长什么样，curl -s URL | xml2json 命令行工具更轻量
• 如果项目里已有成熟 XML struct 定义，坚持走 xml.Unmarshal + json.Marshal，两步都可控、可测、可 debug
• 唯一能考虑第三方库的场景：XML schema 完全未知且动态，且你能接受字段名被强制转小写、空标签变 null、属性丢失

真正麻烦的从来不是“怎么转”，而是 XML 本身不规范：没有 DTD/Schema、属性和子元素混用、编码声明缺失、BOM 头残留。这时候花半小时 fix XML 源，比调三天库参数更省事。