Go 的 reflect 包支持运行时类型和值的动态操作,需用 reflect.TypeOf() 和 reflect.ValueOf() 获取类型与值,结构体字段读写须确保可寻址和可设置,调用方法和读取标签需注意接收者类型与导出性,使用时须严格检查 IsValid、CanAddr、CanSet 等安全条件。

Go 的 reflect 包让你能在运行时获取任意值的类型和值信息,动态访问结构体字段、调用方法、甚至修改可寻址的变量。它不提供泛型那样的编译期安全,但对实现通用序列化、ORM、配置绑定、调试工具等非常关键。
获取类型和值的基本方式
所有反射操作都从 reflect.TypeOf() 和 reflect.ValueOf() 开始。前者返回 reflect.Type,描述“是什么类型”;后者返回 reflect.Value,代表“这个值本身”。
-
reflect.TypeOf(x)返回接口类型,需用.Name()(导出字段名)、.Kind()(底层类别,如struct、ptr、slice)等方法进一步判断 -
reflect.ValueOf(x)返回的值默认不可修改;若要写入,必须传入地址(如&x),再调用.CanSet()确认权限 - 注意:不能对常量、字面量(如
reflect.ValueOf(42))调用.Addr()或.SetXxx()
动态读写结构体字段
对结构体做反射操作最常见。先用 reflect.ValueOf(&s).Elem() 获取可寻址的结构体实例(Elem() 解引用指针),再通过字段名或索引访问字段。
- 按名称获取字段:
v.FieldByName("Name"),返回reflect.Value;若字段未导出(小写开头),该方法返回零值且.IsValid()为false - 按索引获取字段:
v.Field(i),适用于遍历所有导出字段(v.NumField()得到数量) - 读取字段值:
field.Interface()转回原始类型(需类型断言或直接赋值给对应变量) - 写入字段值:
field.SetInt(100)或field.Set(reflect.ValueOf("new")),前提是字段可寻址且可设置
调用方法与检查标签(Tag)
结构体方法可通过 reflect.Value.MethodByName() 获取并调用;字段标签(如 json:"name")则通过 reflect.StructField.Tag 提取。
立即学习“go语言免费学习笔记(深入)”;
- 调用方法:确保接收者是值或指针类型匹配(例如指针方法需传
&s),然后method.Call([]reflect.Value{...}),参数需包装成reflect.Value切片 - 读取 tag:
field.Tag.Get("json")返回字符串,可解析为键值对(如"name,omitempty");常用strings.SplitN(tag, ",", 2)拆分 key 和 option - 注意:tag 只对导出字段有效;未导出字段的 tag 无法通过反射访问
安全使用 reflect 的关键提醒
反射易出 panic,务必做充分检查。
- 总是检查
.IsValid()再调用.Interface()或.Set() - 修改前确认
.CanAddr()和.CanSet(),尤其注意是否传了指针 - 避免在热路径频繁使用反射;考虑缓存
reflect.Type或字段索引(如用map[reflect.Type][]int记录字段偏移)提升性能 - 类型断言失败会 panic,推荐用
v.Interface().(type)或先v.Kind() == reflect.String判断再转换










