使用反射可动态解析结构体字段及json标签,实现自定义JSON序列化;2. 通过reflect遍历字段,结合标签和零值判断,构建含非零值的map;3. 支持嵌套结构体与指针的递归处理;4. 适用于字段过滤、运行时解析等场景,灵活性高但性能低于标准库。

在Go语言中,JSON序列化通常通过
encoding/json包完成,对结构体字段自动处理。但有时我们需要自定义行为,比如动态解析结构体字段、根据标签决定是否导出、或在运行时决定字段值。这时可以借助反射(reflect)来实现更灵活的JSON序列化逻辑。
1. 使用反射获取结构体字段信息
通过
reflect.Value和
reflect.Type,可以在运行时遍历结构体字段,读取字段名、类型、值以及结构体标签(如
json:"name")。
示例结构体:
type User struct {
Name string `json:"name"`
Age int `json:"age,omitempty"`
City string `json:"city,omitempty"`
}
使用反射读取字段:
val := reflect.ValueOf(user)
typ := reflect.TypeOf(user)
for i := 0; i
field := val.Field(i)
fieldType := typ.Field(i)
jsonTag := fieldType.Tag.Get("json")
if jsonTag == "" || jsonTag == "-" {
continue
}
tagName := jsonTag
if idx := strings.Split(jsonTag, ","); len(idx) > 0 {
tagName = idx[0]
}
fmt.Printf("%s: %v\n", tagName, field.Interface())
}
2. 动态构建JSON键值对
结合反射和
map[string]interface{},可以动态构造JSON对象,跳过零值字段(模拟omitempty)。
关键判断逻辑:
- 字段是否为零值:
field.IsZero()
(Go 1.13+)或field.Interface() == reflect.Zero(field.Type()).Interface()
- 标签中是否包含
omitempty
,决定是否跳过零值 - 提取
json
标签主名称作为键
示例代码片段:
result := make(map[string]interface{})
for i := 0; i
field := val.Field(i)
fieldType := typ.Field(i)
tag := fieldType.Tag.Get("json")
if tag == "" || tag == "-" {
continue
}
parts := strings.Split(tag, ",")
key := parts[0]
omitEmpty := false
for _, opt := range parts[1:] {
if opt == "omitempty" {
omitEmpty = true
}
}
if omitEmpty && field.IsZero() {
continue
}
result[key] = field.Interface()
}
3. 处理嵌套结构体和指针
反射还能处理复杂类型,如嵌套结构体或指针字段。需要递归调用或解引用。
例如,字段是指针:
if field.Kind() == reflect.Ptr && !field.IsNil() {
field = field.Elem()
}
if field.Kind() == reflect.Struct {
// 递归处理子结构体
result[key] = structToMap(field)
} else {
result[key] = field.Interface()
}
4. 实际使用场景
这种动态序列化适合以下场景:
- 字段动态过滤(如API响应按角色隐藏字段)
- 结构体字段不确定,需运行时解析
- 需要兼容多种版本JSON格式
- 日志记录中只输出非零值字段
注意:反射性能低于标准
json.Marshal,仅在标准库无法满足时使用。
基本上就这些。通过反射,你可以完全掌控结构体到JSON的转换过程,实现动态、条件化序列化。虽然灵活,但要小心处理类型和边界情况。










