Golang反射实现JSON序列化技巧解析

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

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

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

如何获取结构体字段信息

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

• 使用 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）。

这里要用到 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 数据了。一般做法是：

1. 创建一个 map[string]interface{}
2. 遍历结构体字段
3. 检查是否导出（字段名首字母大写）、是否为零值、是否有 json:"-" 标签
4. 如果符合条件，将字段值加入 map
5. 最后调用 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 在做结构体序列化时的核心流程之一。

实际开发中的一些注意事项

• 私有字段不会被反射访问到：结构体字段必须首字母大写，否则无法被反射访问。
• 标签处理要灵活：有时候标签里会包含选项如 omitempty，需要用字符串分割来判断。
• 性能问题要考虑：反射本身效率较低，频繁调用时建议缓存结构体信息。
• 匿名字段也要处理：如果结构体中嵌套了其他结构体，记得递归处理它们。

基本上就这些内容。掌握了结构体字段遍历和反射的基本操作，你就能写出一个简单的 JSON 编码器了。虽然比不上标准库完整，但在某些特定场景下还是挺实用的。