Golang中如何用encoding/json实现XML转JSON

在Golang开发中，XML和JSON是两种常见的数据交换格式，很多时候我们需要将接收到的XML数据转换为JSON格式返回给前端或者其他服务。很多开发者第一时间会想到寻找第三方XML转JSON库，但实际上Golang标准库自带的encoding/xml和encoding/json就可以完成这个需求，无需引入额外依赖。

核心实现思路

转换的核心逻辑分为三步：首先定义与XML结构对应的Golang结构体，使用encoding/xml解析XML数据到结构体实例中；然后将结构体实例通过encoding/json序列化为JSON格式的字节数据；最后将字节数据转换为字符串即可得到最终的JSON结果。

具体实现步骤

1. 定义匹配XML的结构体

需要根据XML的实际结构定义对应的结构体，并且通过结构体标签指定XML元素的映射关系。比如我们有一个如下的XML数据：

<user>
    <id>1001</id>
    <name>张三</name>
    <age>25</age>
    <hobbies>
        <hobby>读书</hobby>
        <hobby>运动</hobby>
    </hobbies>
</user>

对应的Golang结构体定义如下：

package main

import (
    "encoding/xml"
    "encoding/json"
    "fmt"
)

// User 对应XML的user根节点
type User struct {
    XMLName  xml.Name `xml:"user"`
    ID       int      `xml:"id"`
    Name     string   `xml:"name"`
    Age      int      `xml:"age"`
    Hobbies  Hobbies  `xml:"hobbies"`
}

// Hobbies 对应hobbies节点
type Hobbies struct {
    Hobby []string `xml:"hobby"`
}

2. 解析XML数据到结构体

使用xml.Unmarshal方法将XML字节数据解析到定义好的结构体实例中，需要注意处理解析过程中的错误。

func main() {
    // 原始XML数据
    xmlData := []byte(`<user>
    <id>1001</id>
    <name>张三</name>
    <age>25</age>
    <hobbies>
        <hobby>读书</hobby>
        <hobby>运动</hobby>
    </hobbies>
</user>`)

    var user User
    // 解析XML到结构体
    err := xml.Unmarshal(xmlData, &user)
    if err != nil {
        fmt.Println("XML解析失败:", err)
        return
    }
}

3. 将结构体序列化为JSON

解析完成后，使用json.Marshal或者json.MarshalIndent将结构体实例转换为JSON数据，json.MarshalIndent可以生成带缩进的格式化JSON，方便查看。

    // 序列化为格式化的JSON
    jsonData, err := json.MarshalIndent(user, "", "    ")
    if err != nil {
        fmt.Println("JSON序列化失败:", err)
        return
    }
    // 输出结果
    fmt.Println("转换后的JSON数据:")
    fmt.Println(string(jsonData))
}

转换结果说明

上述代码运行后会输出如下JSON结果：

{
    "XMLName": {
        "Space": "",
        "Local": "user"
    },
    "ID": 1001,
    "Name": "张三",
    "Age": 25,
    "Hobbies": {
        "Hobby": [
            "读书",
            "运动"
        ]
    }
}

如果不需要XMLName字段，可以在结构体定义时去掉XMLName字段，或者在序列化前对结构体做处理，也可以给XMLName字段添加json:"-"标签，让json序列化时忽略该字段，修改后的结构体如下：

type User struct {
    XMLName  xml.Name `xml:"user" json:"-"`
    ID       int      `xml:"id"`
    Name     string   `xml:"name"`
    Age      int      `xml:"age"`
    Hobbies  Hobbies  `xml:"hobbies"`
}

注意事项

• 结构体标签的映射必须准确，xml标签的名称要和XML元素名称完全一致，否则会解析失败或者得到空值。
• 如果XML中有属性，需要使用xml:"attr"标签来映射，比如<user id="1001">中的id是属性，结构体字段标签要写成xml:"id,attr"。
• 如果XML元素名称包含特殊字符或者和Golang关键字冲突，可以在xml标签中使用完整的元素路径来映射。
• 转换后的JSON字段名称默认和结构体字段名称一致，如果需要自定义JSON字段名，可以给结构体字段添加json:"自定义名称"的标签。

适用场景

这种方式适合XML结构相对固定、不需要复杂转换逻辑的场景，如果XML结构非常复杂，或者需要动态处理不同的XML结构，可能需要额外编写通用的解析逻辑，或者考虑使用支持动态XML解析的第三方库。但对于大多数常规XML转JSON的需求，标准库的encoding/xml和encoding/json已经足够使用，还能减少项目依赖，提升代码的可维护性。

GolangXML转JSONencoding_jsonencoding_xml修改时间：2026-07-19 14:06:27