17370845950

如何使用 Golang 反射遍历结构体字段_Golang 动态字段扫描实战
使用反射可动态获取结构体字段信息并修改值,需传入指针且字段导出。1. 通过reflect.ValueOf和reflect.TypeOf获取值与类型;2. 调用.Elem()解指针;3. 遍历字段读取名称、类型、标签;4. 用Field(i)获取字段值,Type().Field(i)获取元信息;5. 通过Tag.Get读取json等标签;6. field.Set修改可导出字段值;7. 处理嵌套结构体需递归遍历。示例实现字段检查、字符串清空与深度遍历,适用于序列化、校验等场景。

在 Golang 中,结构体字段通常是静态定义的,但有时我们需要在运行时动态获取字段信息,比如做序列化、配置映射、数据校验等。这时就要用到反射(reflect)。通过反射,我们可以遍历结构体字段,读取字段名、类型、标签,甚至修改字段值。

使用 reflect 遍历结构体字段的基本步骤

要遍历结构体字段,核心是使用 reflect.ValueOfreflect.TypeOf 获取对象的类型和值信息。注意:如果要修改字段,传入的必须是指针,并且字段需为导出字段(首字母大写)。

基本流程如下:

  • 传入结构体指针,使用 reflect.ValueOf 获取其反射值
  • 调用 .Elem() 获取指针指向的实际值
  • 使用 .Type() 获取结构体类型信息
  • 通过 .NumField() 获取字段数量,再循环遍历每个字段
  • 使用 .Field(i) 获取字段值,.Type().Field(i) 获取字段元信息

读取字段名、类型与标签

结构体标签(struct tag)常用于标记 JSON 名称、数据库列名等。反射可以提取这些标签内容。

示例代码:

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string `json:"name" validate:"required"`
    Age  int    `json:"age" validate:"min=0"`
    Email string `json:"email,omitempty"`
}

func inspectStruct(s interface{}) {
    v := reflect.ValueOf(s).Elem()
    t := v.Type()

    for i := 0; i < v.NumField(); i++ {
        field := v.Field(i)
        structField := t.Field(i)

        fmt.Printf("字段名: %s\n", structField.Name)
        fmt.Printf("字段类型: %s\n", field.Type())
        fmt.Printf("字段值: %v\n", field.Interface())

        if jsonTag := structField.Tag.Get("json"); jsonTag != "" {
            fmt.Printf("JSON 标签: %s\n", jsonTag)
        }

        if validateTag := structField.Tag.Get("validate"); validateTag != "" {
            fmt.Printf("校验规则: %s\n", validateTag)
        }
        fmt.Println("---")
    }
}

func main() {
    user := User{Name: "Alice", Age: 30, Email: "alice@example.com"}
    inspectStruct(&user)
}

输出结果会显示每个字段的名称、类型、当前值以及 json 和 validate 标签内容。

动态修改结构体字段值

反射不仅可以读取字段,还能在运行时修改字段值,前提是该字段可寻址且可设置(exported)。

示例:将所有字符串字段清空

func clearStringFields(s interface{}) {
    v := reflect.ValueOf(s).Elem()

    for i := 0; i < v.NumField(); i++ {
        field := v.Field(i)
        if field.Kind() == reflect.String {
            field.Set(reflect.Zero(field.Type()))
        }
    }
}

// 调用
user := User{Name: "Bob", Age: 25, Email: "bob@example.com"}
clearStringFields(&user)
fmt.Printf("%+v\n", user) // {Name: Age:25 Email:}

这里使用 field.Set() 修改值,reflect.Zero() 获取对应类型的零值。

处理嵌套结构体与匿名字段

如果结构体包含嵌套结构或匿名字段,需要递归遍历。可以通过检查字段是否为结构体类型来决定是否深入。

简单示例:

func walkStruct(v reflect.Value) {
    if v.Kind() == reflect.Ptr {
        v = v.Elem()
    }

    for i := 0; i < v.NumField(); i++ {
        field := v.Field(i)
        if field.Kind() == reflect.Struct {
            walkStruct(field) // 递归处理嵌套结构体
        } else {
            fmt.Printf("%s = %v\n", v.Type().Field(i).Name, field.Interface())
        }
    }
}

这样可以深度扫描整个结构体树形结构。

基本上就这些。Golang 反射虽然不如其他语言灵活,但在配置解析、ORM 映射、API 序列化等场景非常实用。关键是理解 ValueType 的区别,以及指针和可设置性的要求。用好反射,能让代码更通用、更自动化。