Golang如何通过反射获取结构体标签-Golang-PHP中文网

Golang如何通过反射获取结构体标签

P粉602998670

发布： 2025-10-20 14:20:02

原创

910人浏览过

答案：Go通过reflect包可读取结构体字段标签，用于序列化、数据库映射等。1. 标签语法为反引号包围的键值对，如json:"name"。2. 使用reflect.TypeOf获取类型，遍历字段并调用Field(i).Tag.Get("key")提取标签值。3. 多选项标签可用strings.Split分离主键与选项，如"omitempty"。4. 仅导出字段（首字母大写）可读取标签；未存在标签返回空字符串；键名区分大小写。此技术广泛应用于ORM、序列化库开发中。

golang如何通过反射获取结构体标签

在Go语言中，可以通过反射（reflect包）获取结构体字段上的标签（tag）。结构体标签常用于定义字段的序列化方式、数据库映射、验证规则等。下面介绍如何使用反射读取这些标签。

1. 结构体标签的基本语法

结构体标签写在字段后面，用反引号包围，格式为键值对：

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

登录后复制

上面例子中，json 和 db 就是标签的键，后面的字符串是对应的值。

2. 使用 reflect 获取标签

通过 reflect.TypeOf 获取结构体类型，再遍历字段，调用 Field(i).Tag.Get(key) 方法提取指定标签的值。

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

示例代码：

Magic Write

Canva旗下AI文案生成器

查看详情

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
    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, json标签: %s, db标签: %s\n", 
            field.Name, jsonTag, dbTag)
    }
}

登录后复制

输出结果：

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

登录后复制

3. 处理标签中的选项（如omitempty）

有些标签包含多个选项，比如 json:"name,omitempty"。可以使用 strings.Split 分割处理：

jsonTag := field.Tag.Get("json")
if jsonTag != "" {
    parts := strings.Split(jsonTag, ",")
    key := parts[0]  // 实际键名
    options := parts[1:] // 如omitempty
    fmt.Println("键:", key, "选项:", options)
}

登录后复制

这样可以分离出字段名和附加选项，便于进一步处理。