Go 的 reflect 包支持运行时类型与值的动态获取及结构化操作,适用于 ORM 等场景;需传接口值,仅导出成员可访问;操作前须校验有效性、可寻址性与可设置性以避免 panic。

Go 的 reflect 包允许你在运行时动态获取变量的类型、字段、方法等信息,适用于泛型受限场景(如 ORM、序列化、配置绑定等)。它不提供“动态调用任意函数”的自由度,但足够支撑结构化反射操作。
获取基础类型与值信息
使用 reflect.TypeOf() 和 reflect.ValueOf() 分别获取接口背后的类型描述和值描述。注意:必须传入接口值,且导出字段/方法才可被反射访问。
-
reflect.TypeOf(x)返回reflect.Type,描述类型本身(如结构体名、是否是指针、是否为切片等) -
reflect.ValueOf(x)返回reflect.Value,封装实际值,并支持取地址、调用、修改(需可寻址且可设置) - 对指针变量,建议先用
Elem()解引用再操作字段,否则无法读写结构体字段
遍历结构体字段并读取值
仅适用于导出(大写开头)字段。通过 Type.Field(i) 或 Type.FieldByName(name) 获取字段描述;用 Value.Field(i) 或 Value.FieldByName(name) 获取对应值。
- 字段名、标签(tag)、类型、是否导出均可通过
StructField获取,例如sf.Name、sf.Tag.Get("json") - 若原始值是结构体指针,
ValueOf(ptr).Elem()得到结构体值,才能调用Field() - 未导出字段反射时返回零值,且
CanInterface()为 false,不能转回原类型
检查并调用方法
反射只能调用导出方法(首字母大写),且接收者必须满足可调用条件(如传入指针时,方法接收者也应为指针)。
立即学习“go语言免费学习笔记(深入)”;
- 用
Type.NumMethod()和Type.Method(i)遍历方法,获取名称、签名、是否导出等 - 用
Value.MethodByName("Name").Call([]reflect.Value{...})调用,参数必须是reflect.Value切片,且类型需匹配 - 若方法有返回值,
Call()返回[]reflect.Value,需手动解包,例如rets[0].Interface()
安全反射的关键提醒
反射易出 panic,务必做前置校验。
- 调用前检查
Value.Kind() == reflect.Struct、Value.CanAddr()、Value.CanInterface() - 访问字段前确认
Value.IsValid()和Value.CanInterface(),避免 “invalid memory address” - 修改字段值前,确保
Value.CanSet()为 true(通常要求原值为可寻址指针) - 避免在热路径频繁反射,性能开销明显;可缓存
reflect.Type和字段索引提升效率










