Go反射字段过滤需先确保字段导出,再依tag、类型或名称筛选,最后构建map或新struct;关键在处理导出性、匿名字段、tag解析及类型安全赋值。

用 Go 反射做 struct 字段过滤,核心是遍历 reflect.StructField 并按需保留或跳过字段,关键在于明确筛选条件(如标签、类型、导出性)并安全地构造新结构体或映射。
识别可导出字段与结构体基础信息
Go 反射要求字段必须导出(首字母大写)才能被 reflect.Value 读取。先用 reflect.TypeOf 和 reflect.ValueOf 获取类型与值,再通过 t.NumField() 遍历字段:
- 用
t.Field(i)获取StructField,检查IsExported()确保可访问 - 跳过匿名字段(
Anonymous == true)或非导出字段,避免 panic - 注意:即使字段导出,若其类型本身不可反射(如未导出的内部 struct),仍可能无法取值
基于 struct tag 进行字段筛选
最常用方式是通过自定义 tag(如 json:"name,omitempty" 或 filter:"true")控制是否包含该字段:
- 用
field.Tag.Get("filter")获取 tag 值,判断是否为"true"、"include"或非空 - 支持多 tag 组合,例如同时检查
json和filter:只有两者都满足才保留 - 建议统一约定 tag 语义,比如
filter:"-"表示排除,filter:"auto"表示按类型自动处理
按字段类型或名称动态过滤
有时需屏蔽敏感字段(如 Password、Token)或忽略特定类型(如 func、unsafe.Pointer):
立即学习“go语言免费学习笔记(深入)”;
- 用
field.Type.Kind()判断基础类型:reflect.Func、reflect.UnsafePointer、reflect.Chan通常应跳过 - 用
strings.Contains(strings.ToLower(field.Name), "password")快速模糊匹配敏感名 - 对时间、数字等类型可额外加逻辑,例如只保留
time.Time的格式化字符串而非原始值
构建过滤后的新结构或 map
反射不能直接“删减” struct 类型,但可将符合条件的字段提取为 map[string]interface{} 或填充到目标 struct:
- 推荐先收集字段名和值到
map[string]interface{},便于序列化或日志输出 - 若需构造新 struct 实例,需预先定义对应类型,再用
reflect.New(t).Elem()创建值,逐个Set()赋值(注意类型匹配) - 避免在循环中频繁调用
reflect.Value.Interface(),可缓存或用field.Type.Kind()分支处理提升性能
基本上就这些。反射字段过滤不复杂但容易忽略导出性、panic 边界和 tag 解析容错,实际用时建议封装成通用函数,配合测试覆盖常见 struct 场景。










