Golang如何使用reflect实现序列化_Golang reflect对象序列化与反序列化实践-Golang-PHP中文网

Golang如何使用reflect实现序列化_Golang reflect对象序列化与反序列化实践

P粉602998670

发布： 2025-11-27 13:43:11

原创

222人浏览过

答案：通过reflect包可在运行时动态处理结构体字段，实现自定义序列化与反序列化。先用reflect.ValueOf获取值信息，判断是否为指针并取其Elem；再遍历结构体字段，结合reflect.Type获取tag信息，按json规则提取键名；对字段调用Interface()获取值存入map，或通过Set设置可寻址字段，需注意字段可导出、可设置及类型匹配问题。

golang如何使用reflect实现序列化_golang reflect对象序列化与反序列化实践

在 Golang 中，标准库提供了 encoding/json、encoding/xml 等包用于常见格式的序列化与反序列化。但当我们需要实现自定义编码器、或者处理不支持 tag 的结构体时，reflect 包就变得非常关键。通过反射（reflect），我们可以在运行时动态获取结构体字段、类型信息，并实现通用的序列化与反序列化逻辑。

理解 reflect 基本操作

要使用 reflect 实现序列化，先掌握两个核心类型：

reflect.Value：表示一个值的运行时数据
reflect.Type：表示一个类型的元信息

对于结构体，可以通过遍历字段来读取或设置值。例如：

val := reflect.ValueOf(obj)
if val.Kind() == reflect.Ptr {
  val = val.Elem()
}
for i := 0; i < val.NumField(); i++ {
  field := val.Field(i)
  fieldType := val.Type().Field(i)
  fmt.Println(fieldType.Name, field.Interface())
}

使用 reflect 实现简易 JSON 序列化

我们可以基于 reflect 模拟 json.Marshal 的行为，忽略标准库，手动构建 map 或字节流。

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

以下是一个简化版的结构体转 map[string]interface{} 示例：

MarsX

AI驱动快速构建App，低代码无代码开发，改变软件开发的游戏规则

159

查看详情

func ToMap(obj interface{}) (map[string]interface{}, error) {
  result := make(map[string]interface{})
  val := reflect.ValueOf(obj)
  if val.Kind() == reflect.Ptr {
    val = val.Elem()
  }
  if val.Kind() != reflect.Struct {
    return nil, fmt.Errorf("expected struct")
  }
  typ := val.Type()
  for i := 0; i < val.NumField(); i++ {
    field := val.Field(i)
    fieldType := typ.Field(i)
    jsonTag := fieldType.Tag.Get("json")
    if jsonTag == "-" { continue }
    key := fieldType.Name
    if jsonTag != "" {
      if commaIdx := strings.Index(jsonTag, ","); commaIdx > 0 {
        key = jsonTag[:commaIdx]
      } else {
        key = jsonTag
      }
    }
    if key == "" || !field.CanInterface() {
      continue
    }
    result[key] = field.Interface()
  }
  return result, nil
}

这样就可以将结构体按 json tag 规则转换为 map，再用 json.Marshal 输出。

反序列化：从 map 填充结构体字段

反序列化更复杂，因为需要设置字段值，且必须确保目标可寻址。

示例：从 map[string]interface{} 反向填充结构体：

func FromMap(data map[string]interface{}, obj interface{}) error {
  val := reflect.ValueOf(obj)
  if val.Kind() != reflect.Ptr || val.IsNil() {
    return fmt.Errorf("obj must be non-nil pointer")
  }
  val = val.Elem()
  typ := val.Type()
  for i := 0; i < val.NumField(); i++ {
    field := val.Field(i)
    if !field.CanSet() { continue }
    fieldType := typ.Field(i)
    jsonTag := fieldType.Tag.Get("json")
    if jsonTag == "-" { continue }
    key := fieldType.Name
    if jsonTag != "" {
      if idx := strings.Index(jsonTag, ","); idx > 0 {
        key = jsonTag[:idx]
      } else {
        key = jsonTag
      }
    }
    if key == "" { continue }
    if rawVal, found := data[key]; found {
      field.Set(reflect.ValueOf(rawVal))
    }
  }
  return nil
}

注意：实际中需处理类型不匹配、嵌套结构、指针字段等边界情况。