如何使用Golang反射遍历结构体标签_读取元数据和自定义信息

Go反射通过reflect.TypeOf和reflect.ValueOf获取结构体字段的类型、值及标签；仅导出字段可反射，需用Elem()解引用指针，Tag.Get("key")提取标签值，注意大小写敏感和安全判断。

Go 语言的反射（reflect 包）可以动态获取结构体字段的类型、值和标签（tags），是读取自定义元数据（如 JSON 字段名、数据库列名、校验规则等）的核心方式。关键在于：用 reflect.TypeOf 获取类型信息，调用 Field(i).Tag.Get("key") 提取指定标签值。

获取结构体类型并遍历字段

先通过 reflect.TypeOf 得到结构体的 reflect.Type，再用 NumField() 和 Field(i) 逐个访问字段。注意：只能反射导出（首字母大写）的字段。

传入指针或值均可，但 TypeOf 对指针会返回指向类型的类型，需用 Elem() 解引用才能拿到结构体本身
用 t.Kind() == reflect.Struct 做安全判断，避免 panic
字段名通过 f.Name 获取，类型名用 f.Type.Name() 或 f.Type.String()

读取 struct tag 中的元数据

每个字段的标签是字符串，格式为反引号包裹的空格分隔键值对，例如 `json:"name,omitempty" db:"user_name" validate:"required"`。用 f.Tag.Get("json") 即可提取对应值（返回空字符串表示不存在该 tag）。

Tag.Get 自动解析结构，支持带引号/不带引号的值，也处理 omitempty 等后缀（但不自动拆解，需自行解析）
若需解析带逗号的复合 tag（如 validate:"min=10,max=100"），建议用第三方库如 go-playground/validator，或手动按 = 和 , 切分
注意 tag key 区分大小写：Tag.Get("JSON") ≠ Tag.Get("json")

安全读取字段值（配合反射值）

仅获取类型不够，常需同时读字段值。此时要用 reflect.ValueOf 得到 reflect.Value，再用 v.Field(i) 取值。必须确保原始值可寻址（如传指针），否则无法读私有字段或调用 CanInterface()。

用 v := reflect.ValueOf(vInterface); if v.Kind() == reflect.Ptr { v = v.Elem() } 统一处理指针/值
检查 v.CanInterface() 再转回原始类型，避免 “cannot interface with unexported field” 错误
字段值类型可能与声明类型不同（如接口、指针），用 v.Interface() 转为 interface{} 后断言更稳妥

实用示例：通用 JSON 标签映射打印

以下代码遍历结构体，打印每个字段名及其 json 标签名（无则显示字段名）：

type User struct {
    ID    int    `json:"id"`
    Name  string `json:"user_name"`
    Email string `json:"email,omitempty"`
    token string `json:"-"` // 小写字段 + `-` 忽略，不会被遍历到
}

func PrintJSONTags(v interface{}) {
    t := reflect.TypeOf(v)
    if t.Kind() == reflect.Ptr {
        t = t.Elem()
    }
    if t.Kind() != reflect.Struct {
        return
    }

    vVal := reflect.ValueOf(v)
    if vVal.Kind() == reflect.Ptr {
        vVal = vVal.Elem()
    }

    for i := 0; i < t.NumField(); i++ {
        f := t.Field(i)
        jsonTag := f.Tag.Get("json")
        if jsonTag == "" || jsonTag == "-" {
            jsonTag = f.Name
        } else if idx := strings.Index(jsonTag, ","); idx > 0 {
            jsonTag = jsonTag[:idx] // 去掉 omitempty 等后缀
        }
        fmt.Printf("%s → %s\n", f.Name, jsonTag)
    }
}

输出：
ID → id
Name → user_name
Email → email

# js # json # go # golang # ai # 键值对 # red # String # if # 字符串 # 结构体 # 指针 # 接口 # 值类型 # Struct # Interface # typeof # 数据库 # kind # 遍历 # 字段名 # 再用 # 需用 # 切分 # 要用 # 不存在 # 自定义 # 均可 # 不带

返回目录在线咨询

上一篇：云主机建站后，如何进行有效的日常维护和故障排查？
下一篇：部署维护docker环境的详细教程

您的项目需求