17370845950

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，不能转回原类型

检查并调用方法

反射只能调用导出方法（首字母大写），且接收者必须满足可调用条件（如传入指针时，方法接收者也应为指针）。

• 用 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 和字段索引提升效率