如何利用Golang反射读取和解析结构体字段的标签(tag)-Golang-PHP中文网

如何利用Golang反射读取和解析结构体字段的标签(tag)

P粉602998670

发布： 2025-08-30 11:30:03

原创

691人浏览过

首先通过reflect包获取结构体字段的标签，再用Tag.Get方法提取指定键的值，结合字符串处理解析选项，实现序列化、验证、数据库映射等功能。

如何利用golang反射读取和解析结构体字段的标签(tag)

在Go语言中，结构体标签（struct tag）是一种元数据，附加在结构体字段上，常用于控制序列化、数据库映射、验证等行为。通过反射（

reflect

登录后复制

包），我们可以动态读取这些标签内容，实现通用处理逻辑。下面介绍如何使用Golang反射读取并解析结构体字段的标签。

理解结构体标签格式

结构体标签是紧跟在字段后面的字符串，通常采用

key:"value"

登录后复制

的形式。多个标签之间用空格分隔。例如：

type User struct {
    Name  string `json:"name" validate:"required"`
    Age   int    `json:"age" validate:"min=18"`
    Email string `json:"email,omitempty" db:"email"`
}

登录后复制

这里的

json

登录后复制

和

validate

登录后复制

都是标签键，引号内的内容是对应的值。

使用 reflect 获取字段标签

要读取标签，需要使用

reflect.Type

登录后复制

获取结构体类型信息，然后遍历每个字段，调用

Field(i)

登录后复制

获取字段的

StructField

登录后复制

，再通过

Tag

登录后复制

属性读取原始标签字符串。

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

示例代码：

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name  string `json:"name" validate:"required"`
    Age   int    `json:"age" validate:"min=18"`
    Email string `json:"email,omitempty" db:"email"`
}

func main() {
    var u User
    t := reflect.TypeOf(u)

    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        fmt.Printf("字段名: %s\n", field.Name)

        // 读取 json 标签
        jsonTag := field.Tag.Get("json")
        fmt.Printf("  json标签: %s\n", jsonTag)

        // 读取 validate 标签
        validateTag := field.Tag.Get("validate")
        fmt.Printf("  validate标签: %s\n", validateTag)

        // 读取 db 标签
        dbTag := field.Tag.Get("db")
        fmt.Printf("  db标签: %s\n", dbTag)
    }
}

登录后复制

输出结果：

标小兔AI写标书

一款专业的标书AI代写平台，提供专业AI标书代写服务，安全、稳定、速度快，可满足各类招投标需求，标小兔，写标书，快如兔。

查看详情

字段名: Name
  json标签: name
  validate标签: required
  db标签: 
字段名: Age
  json标签: age
  validate标签: min=18
  db标签: 
字段名: Email
  json标签: email,omitempty
  db标签: email

登录后复制

解析标签中的多个选项（如 omitempty）

有些标签值包含多个部分，比如

json:"email,omitempty"

登录后复制

，其中

omitempty

登录后复制

是一个选项。Go标准库提供了

reflect.StructTag

登录后复制

的

Lookup

登录后复制

方法，但更推荐使用

strings

登录后复制

包或正则表达式来解析复杂结构。

简单方式是用

strings.Split

登录后复制

分割：

jsonTag := field.Tag.Get("json")
if jsonTag != "" {
    parts := strings.Split(jsonTag, ",")
    key := parts[0]
    options := parts[1:]
    fmt.Printf("  json键: %s, 选项: %v\n", key, options)
}

登录后复制

这样可以分离出字段名和后续修饰符，便于进一步处理。