Golang结构体标签解析 reflect获取tag值-Golang-PHP中文网

Golang结构体标签解析 reflect获取tag值

P粉602998670

发布： 2025-08-23 11:27:01

原创

544人浏览过

先通过reflect.TypeOf获取结构体类型，再遍历字段并调用Tag.Get方法提取标签值，实现对JSON、DB等标签的动态解析与处理。

golang结构体标签解析 reflect获取tag值

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

结构体标签的基本语法

结构体标签是写在字段后面的字符串，格式为反引号包围的 key:"value" 形式：

示例：

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age,omitempty"`
    ID   uint   `json:"id" db:"user_id"`
}

登录后复制

每个标签可以有多个键值对，用空格分隔。上面的

ID

登录后复制

字段同时有

json

登录后复制

和

db

登录后复制

两个标签。

使用 reflect 解析结构体标签

要获取结构体字段的标签值，需借助 reflect 包。基本流程是：

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

通过
```
reflect.TypeOf
```
登录后复制
获取结构体类型
遍历字段（Field）
调用字段的
```
Tag.Get(key)
```
登录后复制
方法获取指定标签的值

代码示例：

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age,omitempty"`
    ID   uint   `json:"id" db:"user_id"`
}

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

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

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

登录后复制

输出：

字段名: Name
  json标签: name
  db标签: 
字段名: Age
  json标签: age,omitempty
  db标签: 
字段名: ID
  json标签: id
  db标签: user_id

登录后复制

可以看到，

Tag.Get("key")

登录后复制

能准确提取对应标签的值，若标签不存在则返回空字符串。

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

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

json:"age,omitempty"

登录后复制

，其中

omitempty

登录后复制

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

reflect.StructTag

登录后复制

的

Lookup

登录后复制

方法，也支持通过

strings.Split

登录后复制

手动解析。

示例：提取 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)
}

登录后复制

这样可以实现更精细的控制，比如在序列化时判断是否忽略空值。