Golang反射如何实现JSON序列化深入讲解结构体字段遍历技巧-Golang-PHP中文网

Golang反射如何实现JSON序列化深入讲解结构体字段遍历技巧

P粉602998670

发布： 2025-07-20 08:39:02

原创

327人浏览过

golang的反射机制可用于结构体字段遍历和json序列化。1. 使用reflect.typeof()获取结构体类型并遍历字段以读取字段名、类型和标签；2. 通过reflect.valueof()获取字段值，并用iszero()判断是否为空以决定是否输出；3. 构建map[string]interface{}，根据字段名、值和标签组装键值对，最终调用json.marshal()生成json数据；4. 注意事项包括字段导出规则、标签解析、性能优化及匿名字段处理。这些步骤构成了实现自定义json序列化的核心流程。

Golang反射如何实现JSON序列化深入讲解结构体字段遍历技巧

Golang 的反射机制非常强大，尤其在处理结构体字段遍历和 JSON 序列化时特别有用。如果你写过一些中间件、ORM 或者配置解析的代码，就会发现反射几乎是绕不开的一环。

要实现类似 JSON 序列化的功能，关键在于如何通过反射拿到结构体的字段信息，并根据字段类型进行相应处理。下面我们就从几个常用角度出发，看看具体怎么操作。

如何获取结构体字段信息

使用 reflect 包可以轻松获取结构体字段的信息。核心步骤是：

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

使用 reflect.TypeOf() 获取结构体类型
遍历结构体字段（Field）
读取字段名、类型、标签等元数据

举个例子：

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age,omitempty"`
}

func main() {
    u := User{}
    t := reflect.TypeOf(u)
    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        fmt.Println("字段名:", field.Name)
        fmt.Println("JSON标签:", field.Tag.Get("json"))
    }
}

登录后复制

这样就能遍历出所有字段，并提取 JSON 标签的内容。这是构建序列化逻辑的第一步。

字段值的读取与判断是否为空

光有字段类型还不够，我们还需要读取字段的值，并判断它是否为“零值”，以决定是否输出到 JSON 中（比如 omitempty）。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

这里要用到 reflect.ValueOf()，然后配合 IsZero() 方法判断是否为空。

示例代码如下：

v := reflect.ValueOf(u)
for i := 0; i < v.NumField(); i++ {
    val := v.Field(i)
    if val.IsZero() {
        continue // 跳过空值字段
    }
    fmt.Println("字段值:", val.Interface())
}

登录后复制

注意：IsZero() 对结构体嵌套等情况也有效，但对指针类型可能需要额外处理（比如先用 Elem() 取值）。

构建 JSON 键值对的基本思路

有了字段名、值和标签之后，就可以开始拼装 JSON 数据了。一般做法是：

创建一个 map[string]interface{}
遍历结构体字段
检查是否导出（字段名首字母大写）、是否为零值、是否有 json:"-" 标签
如果符合条件，将字段值加入 map
最后调用 json.Marshal() 输出结果

举个简化的流程：

data := make(map[string]interface{})
for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    val := v.Field(i)

    if !val.IsValid() || val.IsZero() {
        continue
    }

    jsonTag := field.Tag.Get("json")
    if jsonTag == "-" {
        continue
    }

    key := jsonTag
    if key == "" {
        key = field.Name
    }

    data[key] = val.Interface()
}

登录后复制

这段逻辑基本就是标准库 encoding/json 在做结构体序列化时的核心流程之一。