在 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 的值(已自动处理引号和选项)。
立即学习“go语言免费学习笔记(深入)”;
如果需要进一步拆解选项(如 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)
}
}
调用 printJSONTags(&User{}) 即可看到各字段的解析结果。










