结构体标签通过反射实现元信息读取，用于序列化、校验等场景。例如定义User结构体含json和validate标签，利用reflect.TypeOf获取类型信息，遍历字段并调用Tag.Get提取标签值，输出各字段对应标签内容。该机制应用于JSON序列化、表单校验、ORM映射等，需注意标签格式规范以确保正确解析。
在Go语言中，结构体标签（Struct Tags）是一种为字段附加元信息的机制，常用于控制序列化、数据库映射、参数校验等行为。结合反射（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 都是自定义标签，用于指示序列化或验证规则。
立即学习“go语言免费学习笔记（深入）”；
通过反射读取结构体标签
使用标准库 reflect 可以在运行时获取结构体字段的标签信息。核心步骤包括：获取类型信息、遍历字段、提取标签。
示例代码：
package main
import (
"fmt"
"reflect"
)
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")
validateTag := field.Tag.Get("validate")
fmt.Printf("字段名: %s, JSON标签: %s, 校验标签: %s\n",
field.Name, jsonTag, validateTag)
}
}
输出结果：
字段名: Name, JSON标签: name, 校验标签: required字段名: Age, JSON标签: age, 校验标签: min=0
字段名: ID, JSON标签: id,omitempty, 校验标签:
实际应用场景举例
结构体标签与反射结合广泛应用于以下场景：
- JSON序列化控制：标准库 encoding/json 就依赖 json 标签来决定字段名和是否忽略空值。
- 表单参数绑定与校验：Web框架如Gin使用 binding 标签解析HTTP请求参数，并根据规则校验数据合法性。
- ORM数据库映射：GORM 使用 gorm 标签将结构体字段映射到数据库列名、主键、索引等。
- 自定义配置解析：可编写通用函数，根据特定标签自动填充配置项或生成文档。
比如一个简单的校验逻辑：
func validateStruct(v interface{}) {
t := reflect.TypeOf(v)
val := reflect.ValueOf(v)
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
tag := field.Tag.Get("validate")
value := val.Field(i)
if tag == "required" && value.Interface() == "" {
fmt.Printf("%s 是必填字段\n", field.Name)
}
}
}
基本上就这些。结构体标签本身不参与逻辑运算，但通过反射能赋予其实际意义，是Go实现声明式编程的重要手段之一。正确使用可大幅提升代码可读性和复用性。不复杂但容易忽略细节，比如标签格式错误会导致 Get 返回空字符串，需注意书写规范。
