如何使用Golang反射获取结构体字段

首先获取结构体类型信息，再遍历字段读取名称、类型、标签及值。1. 使用reflect.TypeOf()获取类型，通过NumField()和Field()遍历字段；2. 用field.Tag.Get()提取json、db等标签；3. 通过reflect.ValueOf()传入实例读取字段值，修改需传指针并调用Elem()；4. 注意仅能访问导出字段，避免性能损耗与panic。

在Go语言中，反射（reflection）是一种强大的机制，允许程序在运行时动态获取变量的类型和值信息。当你需要处理未知结构的结构体，比如实现通用的序列化、ORM映射或配置解析时，使用反射可以灵活地读取结构体字段。

1. 获取结构体类型和字段基本信息

要通过反射获取结构体字段，首先要获取其类型对象（Type）。使用 reflect.TypeOf() 可以得到变量的类型信息。如果该变量是一个结构体，可以通过索引遍历它的字段。

示例代码：

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string
    Age  int
    City string
}

func main() {
    var u User
    t := reflect.TypeOf(u)

    // 遍历结构体字段
    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        fmt.Printf("字段名: %s, 类型: %s\n", field.Name, field.Type)
    }
}

输出结果：

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

2. 访问结构体字段的标签（Tag）

结构体字段常带有标签，用于元数据描述，如JSON序列化、数据库映射等。你可以通过 field.Tag 获取标签内容，并用 Get(key) 方法提取特定键的值。

示例：

type User struct {
    Name string `json:"name" db:"username"`
    Age  int    `json:"age"`
    City string `json:"-"`
}

读取标签：

Poixe AI

统一的 LLM API 服务平台，访问各种免费大模型

61

查看详情

for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    jsonTag := field.Tag.Get("json")
    dbTag := field.Tag.Get("db")
    fmt.Printf("字段: %s, json标签: %s, db标签: %s\n", 
        field.Name, jsonTag, dbTag)
}

输出：

3. 获取字段的实际值（需传入实例）

上面只获取了类型信息。若要读取字段的值，必须传入一个结构体实例，并使用 reflect.ValueOf()。

注意：要修改值，需传入指针并使用 Elem() 解引用。

示例：读取字段值

u := User{Name: "Alice", Age: 30, City: "Beijing"}
v := reflect.ValueOf(u)

for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    value := v.Field(i)
    fmt.Printf("字段: %s, 值: %v\n", field.Name, value.Interface())
}

输出：

4. 注意事项与常见问题

使用反射时要注意以下几点：

• 只有导出字段（大写字母开头）才能通过反射访问值，非导出字段会引发panic
• 修改字段值时，必须传入指针并调用 Value.Elem() 获取可寻址的值
• 性能较低，避免在高频路径使用
• 类型断言错误可能导致 panic，建议先判断类型

基本上就这些。掌握 Type 和 Value 的配合使用，就能灵活处理结构体字段的读取、标签解析和动态赋值。虽然反射功能强大，但应尽量优先考虑静态类型方案。不复杂但容易忽略细节。

以上就是如何使用Golang反射获取结构体字段的详细内容，更多请关注php中文网其它相关文章！