Golang反射获取struct字段方法详解

本文系统梳理了Go语言中利用reflect包安全、高效获取struct字段信息的核心技巧：强调仅导出字段（首字母大写）才可被反射访问，详解如何结合reflect.TypeOf与reflect.ValueOf分别获取类型元数据和运行时值，演示字段名、类型、导出状态判断及tag解析（如json标签）的实用方法，并给出处理嵌套结构、指针传参、CanSet校验与panic防护等关键实践要点——帮你避开反射中最常见的“字段读不到”“赋值失败”“运行时panic”三大坑。

在 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"：

• 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 等复合类型，可递归调用同一逻辑

基本上就这些。反射不复杂但容易忽略导出规则和可寻址性，写工具类时加几行校验就能避开大部分坑。

今天关于《Golang反射获取struct字段方法详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！