Golang如何使用标签tag_Go struct tag语法与反射解析

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Golang如何使用标签tag_Go struct tag语法与反射解析

2025-11-30

浏览次数：次

返回列表

struct tag用于为结构体字段添加元信息，通过反射可在运行时解析这些标签以控制序列化、数据库映射等行为。1. 标签写在反引号内，格式为key:"value"，如json:"name"；2. 使用reflect.TypeOf获取类型信息，遍历字段并调用Field.Tag.Get("key")读取标签值；3. 常见应用包括JSON序列化、GORM数据库映射和参数校验；4. 注意标签必须是字面字符串、字段需导出、多个标签用空格分隔。示例中User结构体的Name字段对应json键名"name"且必填，Email字段在为空时忽略输出。该机制是Go实现元编程的重要方式。

golang如何使用标签tag_go struct tag语法与反射解析

在Go语言中，struct tag 是一种为结构体字段附加元信息的机制，常用于控制序列化（如 JSON、XML）、数据库映射（如 GORM）、参数校验等行为。结合 反射（reflect），程序可以在运行时读取这些标签并做出相应处理。下面详细介绍 struct tag 的语法和如何通过反射解析它们。

struct tag 语法

struct tag 写在结构体字段后面的反引号（``）中，格式为：

`key1:"value1" key2:"value2"`

每个键值对表示一个标签，key 通常是库定义的标识符（如 json、xml、gorm），value 提供具体配置。

示例：

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

说明：

json:"name"：该字段在转为 JSON 时使用 "name" 作为键名
omitempty：如果字段为空值（如 ""、0、nil），序列化时忽略该字段
validate:"required"：用于校验规则，表示该字段必填

通过反射解析 struct tag

要读取 struct tag，需要使用 reflect 包。核心步骤是：

获取结构体类型的 reflect.Type
遍历每个字段（Field）
调用 Field.Tag.Get("key") 获取指定标签值

示例代码：

GoEnhance

全能AI视频制作平台：通过GoEnhance AI让视频创作变得比以往任何时候都更简单。

347 查看详情 GoEnhance

package main

import (
    "fmt"
    "reflect"
)

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

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

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

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

输出：

字段: Name, json tag: name, validate tag: required
字段: Age, json tag: age, validate tag: min=0
字段: Email, json tag: email,omitempty, validate tag:

注意：