如何在Golang中获取字段标签信息_读取struct tag并解析

P粉602998670 2025-12-21 00:00:00 次阅读

在 Go 中可通过 reflect 包获取结构体字段标签，用 StructTag.Get(key) 提取 json、db 等键值，再用 strings.Split 拆分字段名与选项（如 omitempty）；需确保结构体及字段均导出。

在 Go 中，可以通过反射（reflect 包）获取结构体字段的标签（tag），再用 structtag 包或手动解析来提取特定键（如 json、db、validate）对应的值。核心步骤是：获取结构体类型 → 遍历字段 → 读取 Tag → 解析目标 key。

获取字段的原始 tag 字符串

使用 reflect.TypeOf().Field(i).Tag 可以拿到字段的完整 tag 字符串（类型为 reflect.StructTag）。它本质是一个带引号的字符串，例如：`json:"name,omitempty" db:"user_name"`。

注意：必须传入结构体指针或值的反射类型，且字段需导出（首字母大写）才能被反射访问。

错误示例：reflect.TypeOf(s).Field(0).Tag 中 s 是未导出字段，会 panic 或返回空
正确做法：确保结构体和字段都导出，例如 type User struct { Name string `json:"name"` }

用 structtag 包安全解析 tag

golang.org/x/tools/go/ast/structtag 并非标准库，推荐使用更轻量、广泛采用的标准方式：reflect.StructTag.Get(key) 直接提取指定 key 的值（已自动处理引号和选项）。

如果需要进一步拆解选项（如 omitempty、string），可配合 strings 包或正则，但多数场景 Get 已足够：

field.Tag.Get("json") → 返回 "name,omitempty"
field.Tag.Get("db") → 返回 "user_name"
若 key 不存在，返回空字符串

手动解析 tag 值（提取 name 和选项）

当需要区分字段名与选项（如 json:"user_name,omitempty,string" 中的 user_name 和 omitempty），可用标准库 strings 拆分：

val := field.Tag.Get("json")
if val == "" {
    return
}
parts := strings.Split(val, ",")
fieldName := parts[0] // "user_name"
options := parts[1:]  // ["omitempty", "string"]

注意：字段名可能为 "-"（表示忽略），此时应跳过该字段；选项中常见的是 omitempty、string、required 等，按需判断即可。

完整示例：遍历结构体并打印 json tag 信息

以下代码演示如何读取并结构化输出每个字段的 JSON 名称和是否 omitempty：

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

    for i := 0; i < t.NumField(); i++ {
        f := t.Field(i)
        jsonTag := f.Tag.Get("json")
        if jsonTag == "" || jsonTag == "-" {
            continue
        }

        parts := strings.Split(jsonTag, ",")
        name := parts[0]
        var opts []string
        if len(parts) > 1 {
            opts = parts[1:]
        }

        fmt.Printf("Field: %s → JSON name: %q, Options: %v\n", f.Name, name, opts)
    }
}