Go 结构体标签是定义在结构体字段声明后的字符串字面量，属于字段的元信息，不会直接影响字段的存储和访问，但可以在运行时通过反射机制读取，为程序提供额外的配置信息。它广泛应用于各类Go生态的库中，是实现通用功能的重要辅助手段。
结构体标签的基本语法
结构体标签的语法格式非常固定，标签内容需要用反引号包裹，内部是键值对形式，多个键值对之间用空格分隔，键和值之间用冒号分隔，值需要用双引号包裹。示例如下：
package main
import "fmt"
type User struct {
// 单个标签键值对
Name string `json:"name"`
// 多个标签键值对，空格分隔
Age int `json:"age" validate:"required,min=1,max=120"`
// 标签值可以包含特殊字符，只要符合字符串规则即可
Email string `json:"email" gorm:"type:varchar(100);unique_index"`
}
func main() {
u := User{Name: "张三", Age: 25, Email: "test@ipipp.com"}
fmt.Printf("%+vn", u)
}
需要注意的是，结构体标签必须是静态的字符串字面量，不能在标签中使用变量或者表达式，否则会直接编译报错。
通过反射获取结构体标签
结构体标签的核心价值是运行时可读取，Go的reflect包提供了对应的方法获取标签信息。我们可以通过reflect.Type获取结构体的字段信息，再通过字段的Tag属性获取标签内容，Tag类型提供了Get方法获取指定键的值，也提供了Lookup方法判断键是否存在并返回值。
下面是反射获取结构体标签的示例：
package main
import (
"fmt"
"reflect"
)
type Product struct {
ID int `json:"id" db:"product_id"`
Name string `json:"name" db:"product_name"`
Price float64 `json:"price" db:"product_price"`
}
func main() {
p := Product{}
// 获取结构体的反射类型
t := reflect.TypeOf(p)
// 遍历所有字段
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
// 获取json标签的值
jsonTag := field.Tag.Get("json")
// 获取db标签的值，同时判断是否存在
dbTag, ok := field.Tag.Lookup("db")
fmt.Printf("字段名：%s，json标签：%s，db标签存在：%v，db标签值：%sn", field.Name, jsonTag, ok, dbTag)
}
}
常见应用场景
JSON序列化与反序列化
这是结构体标签最常见的使用场景，encoding/json标准库支持通过结构体标签指定字段序列化后的键名、忽略空值、忽略字段等。常用的标签选项如下：
json:"key"：指定序列化后的键名json:"key,omitempty"：当字段为零值时忽略该字段json:"-"：始终忽略该字段，不参与序列化反序列化
示例代码如下：
package main
import (
"encoding/json"
"fmt"
)
type Student struct {
ID int `json:"id"`
Name string `json:"name"`
Age int `json:"age,omitempty"` // 年龄为0时不序列化
Score float64 `json:"-"` // 分数始终不参与序列化
}
func main() {
s1 := Student{ID: 1, Name: "李四", Age: 0, Score: 90.5}
data1, _ := json.Marshal(s1)
fmt.Println(string(data1)) // 输出 {"id":1,"name":"李四"}
s2 := Student{ID: 2, Name: "王五", Age: 18, Score: 88.0}
data2, _ := json.Marshal(s2)
fmt.Println(string(data2)) // 输出 {"id":2,"name":"王五","age":18}
}
数据校验
很多校验库比如go-playground/validator使用结构体标签定义字段的校验规则，比如必填、长度范围、格式校验等。示例如下：
package main
import (
"fmt"
"github.com/go-playground/validator/v10"
)
type RegisterForm struct {
Username string `validate:"required,min=3,max=20"` // 必填，长度3-20
Password string `validate:"required,min=6"` // 必填，最少6位
Email string `validate:"required,email"` // 必填，邮箱格式
}
func main() {
validate := validator.New()
form := RegisterForm{
Username: "ab",
Password: "123",
Email: "invalid-email",
}
err := validate.Struct(form)
if err != nil {
for _, e := range err.(validator.ValidationErrors) {
fmt.Printf("字段 %s 校验失败，规则：%sn", e.Field(), e.Tag())
}
}
}
ORM映射
常用的Go ORM库比如GORM、XORM都使用结构体标签定义表名、字段名、字段属性、索引等信息。以GORM为例，常见标签如下：
| 标签示例 | 作用说明 |
|---|---|
gorm:"column:user_name" | 指定数据库字段名为user_name |
gorm:"primaryKey" | 指定该字段为主键 |
gorm:"type:varchar(50);not null" | 指定字段类型为varchar(50)且非空 |
gorm:"uniqueIndex" | 为该字段创建唯一索引 |
使用注意事项
结构体标签的键值对格式必须严格符合规范，冒号后面的值必须用双引号包裹，否则反射获取时会出现异常。另外不同库的标签键不能冲突，比如不要自定义和json同名的标签键，避免解析错误。
如果标签值中需要包含双引号，需要使用转义符，比如json:"name,"extra""，不过这种场景比较少见，一般建议标签值保持简洁。
结构体标签只是元信息，本身不会执行任何逻辑，所有功能都是依赖读取标签的库实现的，所以使用第三方库的标签时，需要先确认库的标签规则，避免写错标签导致功能不生效。
Go结构体标签Struct_Tags反射修改时间：2026-06-12 21:39:41