Go中反射获取struct字段需用reflect.TypeOf和ValueOf,仅导出字段(首字母大写)可访问;通过StructField.Tag解析标签;读取值需传指针并检查CanSet;遍历时应校验Kind、NumField及CanInterface。

在 Go 中,reflect 包是获取 struct 字段信息的核心工具。关键在于:先用 reflect.TypeOf 获取类型,再用 reflect.ValueOf 获取值;字段必须是**导出字段(首字母大写)**才能被反射访问;若需读取结构体标签(如 json:"name"),要通过 StructField.Tag 解析。
获取字段名、类型和是否导出
通过 reflect.Type.Field(i) 可以拿到第 i 个字段的元信息:
-
field.Name:字段名(如"Name") -
field.Type:字段类型(如string),可进一步调用.Kind()判断基础类型(reflect.String、reflect.Int等) -
field.PkgPath:非空表示该字段未导出(即小写开头),此时反射无法读取其值
读取字段值与处理嵌套结构
字段值需通过 reflect.Value.Field(i) 获取,但前提是字段已导出且 value 是可寻址的(如传入指针):
- 传入 struct 实例:只能读取导出字段,不能修改
- 传入
&struct{}:可读可写(需检查.CanSet()) - 对匿名字段或嵌套 struct,可用
.NumField()和递归方式遍历,用field.Anonymous判断是否为内嵌
解析 struct tag 并提取常用信息
struct tag 是字符串,需用 field.Tag.Get("key") 提取,例如 json:"user_name,omitempty":
立即学习“go语言免费学习笔记(深入)”;
-
field.Tag.Get("json")返回完整 tag 值 - 推荐用标准库
strings.SplitN或第三方包(如golang.org/x/tools/go/analysis/passes/printf不适用,建议手写简单解析)分离 name 和 options - 注意:tag key 区分大小写,
"JSON"和"json"不同
安全遍历所有字段的通用写法
避免 panic 的常见做法:
- 先判断
v.Kind() == reflect.Struct - 用
v.NumField()获取字段数,再循环v.Field(i)和t.Field(i) - 对每个字段,检查
v.Field(i).CanInterface()再取值,或用.Interface()转为 interface{} 安全输出 - 遇到指针、slice、map 等复合类型,可递归调用同一逻辑
基本上就这些。反射不复杂但容易忽略导出规则和可寻址性,写工具类时加几行校验就能避开大部分坑。










