Golang反射遍历结构体标签技巧

本篇文章给大家分享《Golang反射遍历结构体标签方法》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

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  0 {
            jsonTag = jsonTag[:idx] // 去掉 omitempty 等后缀
        }
        fmt.Printf("%s → %s\n", f.Name, jsonTag)
    }
}

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

今天关于《Golang反射遍历结构体标签技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！