如何使用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语言免费学习笔记（深入）”；

字段名: Name, 类型: string
字段名: Age, 类型: int
字段名: City, 类型: string

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

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

示例：

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

读取标签：

即构数智人

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

36

查看详情

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)
}

输出：

字段: Name, json标签: name, db标签: username
字段: Age, json标签: age, db标签:
字段: City, json标签: -, db标签:

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())
}

输出：

字段: Name, 值: Alice
字段: Age, 值: 30
字段: City, 值: Beijing

4. 注意事项与常见问题

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

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

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