如何实现Golang结构体标签解析使用reflect获取tag信息-Golang-PHP中文网

如何实现Golang结构体标签解析使用reflect获取tag信息

P粉602998670

发布： 2025-08-31 11:03:01

原创

848人浏览过

Go语言中结构体标签通过reflect解析可实现序列化、校验等元数据控制，如json:"name"用于字段映射，validate:"required"用于参数校验，结合strings.Split可提取标签选项，广泛应用于ORM、API文档生成等场景。

如何实现golang结构体标签解析使用reflect获取tag信息

在Go语言中，结构体标签（Struct Tags）是一种为字段附加元数据的方式，常用于控制序列化、ORM映射、参数校验等行为。通过 reflect 包，我们可以动态地解析这些标签信息，实现灵活的程序逻辑。

理解结构体标签语法

结构体标签是写在结构体字段后面的字符串，通常以键值对形式存在，格式为：key:"value"。多个标签之间用空格分隔。

例如：

type User struct {
    Name string `json:"name" validate:"required"`
    Age  int    `json:"age" validate:"min=0"`
    ID   string `json:"id,omitempty"`
}

登录后复制

这里的 json 和 validate 都是自定义标签，用于指示字段在JSON序列化或校验时的行为。

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

使用 reflect 获取标签信息

要读取结构体标签，需要使用 reflect 包中的 Field.Tag 字段，再通过 Get 方法提取指定键的值。

基本步骤如下：

使用 reflect.ValueOf 获取结构体的反射值
调用 Type() 获取其类型信息
遍历字段，使用 Field(i).Tag.Get("key") 获取标签内容

示例代码：

微信 WeLM

WeLM不是一个直接的对话机器人，而是一个补全用户输入信息的生成模型。

查看详情

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string `json:"name" validate:"required"`
    Age  int    `json:"age" validate:"min=0"`
    ID   string `json:"id,omitempty"`
}

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

    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        jsonTag := field.Tag.Get("json")
        validateTag := field.Tag.Get("validate")

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

func main() {
    parseTags()
}

登录后复制

输出结果：

字段: Name
  json标签: name
  validate标签: required
字段: Age
  json标签: age
  validate标签: min=0
字段: ID
  json标签: id,omitempty
  validate标签:

登录后复制

解析标签中的复合值（如 omitempty）

有些标签值包含多个选项，比如 json:"id,omitempty"。我们可以使用 strings.Split 拆分处理。

示例：提取 json 标签中的字段名和选项

import "strings"

// 解析 json 标签
jsonTag := field.Tag.Get("json")
if jsonTag != "" {
    parts := strings.Split(jsonTag, ",")
    fieldName := parts[0]
    options := parts[1:] // 如 ["omitempty"]

    fmt.Printf("  字段名: %s, 选项: %v\n", fieldName, options)
}

登录后复制

这样可以分别获取序列化名称和附加指令，便于控制编解码逻辑。