Golang反射遍历结构体字段与方法示例-Golang-PHP中文网

Golang反射遍历结构体字段与方法示例

P粉602998670

发布： 2025-09-23 16:40:01

原创

159人浏览过

答案：Go反射可动态获取结构体类型与值，遍历字段和方法并调用，支持标签解析与字段修改，但需注意可导出性与性能开销。

golang反射遍历结构体字段与方法示例

在Go语言中，反射（reflect）是一种强大的机制，可以在运行时动态获取变量的类型和值，并操作其结构体字段或调用方法。当我们需要对结构体进行通用处理（如序列化、参数校验、ORM映射等）时，反射非常有用。

获取结构体类型与值

使用 reflect.TypeOf 获取变量的类型信息，reflect.ValueOf 获取其值信息。对于结构体，可以通过 Kind() 判断是否为结构体类型。

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
    email string // 小写字段不可导出
}

func (u User) SayHello() {
    fmt.Printf("Hello, I'm %s\n", u.Name)
}

func (u User) Greet(to string) {
    fmt.Printf("Hi %s, I'm %s\n", to, u.Name)
}

func main() {
    u := User{Name: "Alice", Age: 25}

    t := reflect.TypeOf(u)
    v := reflect.ValueOf(u)

    if t.Kind() != reflect.Struct {
        return
    }

    fmt.Printf("Type: %s\n", t.Name())

登录后复制

遍历结构体字段

通过 Type.NumField() 获取字段数量，再使用 Type.Field(i) 和 Value.Field(i) 分别获取字段元信息和值。注意：只能访问可导出字段（首字母大写）。

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

        fmt.Printf("Field: %s, Type: %s, Value: %v", 
            field.Name, field.Type, value.Interface())

        // 获取结构体标签
        if jsonTag := field.Tag.Get("json"); jsonTag != "" {
            fmt.Printf(", json tag: %s", jsonTag)
        }
        fmt.Println()
    }

登录后复制

输出示例：

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

Field: Name, Type: string, Value: Alice, json tag: name
Field: Age, Type: int, Value: 25, json tag: age
Field: email, Type: string, Value:

登录后复制

email 字段虽无值，但仍可遍历到，但它是不可导出字段，无法从外部修改。

即构数智人

即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

查看详情

遍历并调用结构体方法

使用 Type.NumMethod() 遍历方法，Type.Method(i) 获取方法元信息，Value.Method(i).Call() 可调用方法。注意：只有可导出方法（大写开头）才能被反射调用。

    for i := 0; i < t.NumMethod(); i++ {
        method := t.Method(i)
        fmt.Printf("Method: %s, Type: %s\n", method.Name, method.Type)
    }

    // 调用无参方法
    mv1 := v.MethodByName("SayHello")
    if mv1.IsValid() {
        mv1.Call(nil)
    }

    // 调用有参方法
    mv2 := v.MethodByName("Greet")
    if mv2.IsValid() {
        args := []reflect.Value{reflect.ValueOf("Bob")}
        mv2.Call(args)
    }

登录后复制

输出：

Method: Greet, Type: func(main.User, string)
Method: SayHello, Type: func(main.User)
Hello, I'm Alice
Hi Bob, I'm Alice

登录后复制

修改结构体字段值（需传入指针）

如果想通过反射修改字段，必须传入结构体指针，并使用 Elem() 获取指向的值。

    uptr := &User{Name: "Bob", Age: 20}
    vptr := reflect.ValueOf(uptr)
    v = vptr.Elem() // 获取指针指向的实例

    nameField := v.FieldByName("Name")
    if nameField.CanSet() {
        nameField.SetString("Charlie")
    }

登录后复制

CanSet() 判断字段是否可设置，未导出字段或非指针传递会导致返回 false。

基本上就这些。Go反射虽然灵活，但性能较低，应避免频繁使用。理解 Type 与 Value 的区别、字段与方法的遍历方式，以及可导出性限制，是正确使用的关键。

以上就是Golang反射遍历结构体字段与方法示例的详细内容，更多请关注php中文网其它相关文章！