Golang如何通过reflect获取结构体tag信息_Golang reflect结构体tag操作实践-Golang-PHP中文网

Golang如何通过reflect获取结构体tag信息_Golang reflect结构体tag操作实践

P粉602998670

发布： 2025-10-29 16:08:02

原创

407人浏览过

答案：本文介绍Go语言中通过reflect包获取结构体tag信息的方法。首先使用reflect.TypeOf()获取类型，遍历字段后通过Field(i).Tag.Get("key")提取指定键值，如json、db、validate等；对于复合tag如validate:"required,max=10"，可结合strings.Split解析为规则列表；该技术广泛应用于JSON序列化、数据库映射、数据验证和API文档生成等场景，提升程序灵活性。

golang如何通过reflect获取结构体tag信息_golang reflect结构体tag操作实践

在 Go 语言中，reflect 包提供了运行时反射能力，可以动态获取变量类型、值以及结构体字段的元信息。其中，结构体的 tag 是一种常见的元数据标注方式，常用于 JSON 序列化、数据库映射、表单验证等场景。本文将介绍如何使用 reflect 获取结构体 tag 信息，并结合实际操作示例帮助理解。

理解结构体 Tag 的基本语法

结构体字段可以附加 tag，格式为字符串，通常包含多个键值对：

type User struct {
    Name string `json:"name" validate:"required"`
    Age  int    `json:"age" db:"user_age"`
}

登录后复制

每个 tag 由一个或多个“键:"值"”组成，用空格分隔。通过 reflect 可以提取这些信息。

使用 reflect 获取字段 tag 值

要获取结构体字段的 tag，需要以下步骤：

立即学习“go语言免费学习笔记（深入）”；

使用 reflect.TypeOf() 获取结构体类型
遍历字段（Field），通过 Field(i).Tag 得到 tag 字符串
调用 Get(key) 方法提取指定 key 的值

示例代码：

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string `json:"name" validate:"required"`
    Age  int    `json:"age" db:"user_age"`
}

func main() {
    t := reflect.TypeOf(User{})
    
    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        jsonTag := field.Tag.Get("json")
        validateTag := field.Tag.Get("validate")
        dbTag := field.Tag.Get("db")

        fmt.Printf("字段: %s\n", field.Name)
        fmt.Printf("  json tag: %s\n", jsonTag)
        fmt.Printf("  validate tag: %s\n", validateTag)
        fmt.Printf("  db tag: %s\n", dbTag)
    }
}

登录后复制

输出结果：

BibiGPT-哔哔终结者

B站视频总结器-一键总结音视频内容

查看详情

字段: Name
  json tag: name
  validate tag: required
  db tag: 
字段: Age
  json tag: age
  db tag: user_age

登录后复制

解析复杂 tag：支持多属性与自定义规则

有些场景下 tag 值可能包含多个参数，例如 validate:"required,max=10"。此时可以通过字符串分割进一步解析。

示例：解析 validate tag 中的规则

func parseValidateTag(tag string) []string {
    if tag == "" {
        return nil
    }
    return strings.Split(tag, ",")
}

// 在 main 中调用
validateTag := field.Tag.Get("validate")
rules := parseValidateTag(validateTag)
fmt.Printf("  校验规则: %v\n", rules)

登录后复制

这样就可以把 "required,max=10" 拆分为 ["required", "max=10"] 进行后续处理。