Golang如何定义并使用结构体标签_Golang 结构体标签使用实践-Golang-PHP中文网

Golang如何定义并使用结构体标签_Golang 结构体标签使用实践

P粉602998670

发布： 2025-11-18 17:52:02

原创

617人浏览过

结构体标签是Go中为字段添加元信息的机制，用反引号包围，形式为key:"value"，可通过反射读取。常用于JSON序列化（如json:"name"）、数据库映射（如gorm:"primaryKey"）和参数校验（如validate:"required"），提升代码可读性与灵活性。

golang如何定义并使用结构体标签_golang 结构体标签使用实践

在 Go 语言中，结构体标签（Struct Tags）是一种为结构体字段附加元信息的机制，常用于控制序列化、反序列化行为，比如 JSON、XML、BSON 的编码解码。合理使用结构体标签能提升代码的可读性和灵活性。

什么是结构体标签

结构体标签是写在结构体字段后面的字符串注解，用反引号（``）包围，通常以 key:"value" 形式存在。这些标签不会影响程序运行，但可以通过反射（reflect）在运行时读取，被标准库或第三方库解析使用。

例如：

type User struct {<br>    Name string `json:"name"`<br>    Age  int    `json:"age,omitempty"`<br>    ID   string `json:"-"` // 表示不参与 JSON 编码<br>}

登录后复制

上面的 json:"name" 就是结构体标签，告诉 encoding/json 包在序列化时将 Name 字段映射为 JSON 中的 "name" 字段。

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

常见标签使用场景

结构体标签广泛应用于数据格式转换和校验。以下是几个典型用途：

1. JSON 序列化与反序列化
通过 json 标签控制字段名、是否忽略空值等。

type Product struct {<br>    Title       string  `json:"title"`<br>    Price       float64 `json:"price"`<br>    Sku         string  `json:"sku,omitempty"` // 空字符串时不输出<br>    CreatedTime int64   `json:"created_time,string"` // 数值转为字符串输出<br>}

登录后复制

当 Price 为 0 或 Sku 为空时，Sku 字段不会出现在 JSON 输出中。

2. 数据库映射（如 GORM）
在使用 GORM 等 ORM 框架时，常用标签指定数据库字段名、主键、索引等。

type User struct {<br>    ID   uint   `gorm:"primaryKey"`<br>    Name string `gorm:"column:username;size:100"`<br>    Email string `gorm:"uniqueIndex"`<br>}

登录后复制

知我AI·PC客户端

离线运行 AI 大模型，构建你的私有个人知识库，对话式提取文件知识，保证个人文件数据安全

查看详情

这里 gorm 标签告诉 GORM 如何映射到数据库表结构。

3. 请求参数校验
结合 validator 标签可在 API 接收数据时做字段校验。

import "github.com/go-playground/validator/v10"<br><br>type LoginReq struct {<br>    Username string `json:"username" validate:"required,email"`<br>    Password string `json:"password" validate:"required,min=6"`<br>}

登录后复制

使用 validator 库可以验证请求体是否符合规则。

如何读取结构体标签

通过反射（reflect）可以在运行时获取结构体字段的标签内容，适用于自定义序列化器、配置解析器等场景。

package main<br><br>import (<br>    "fmt"<br>    "reflect"<br>)<br><br>type Person struct {<br>    Name string `json:"full_name" xml:"name"`<br>    Age  int    `json:"age" xml:"age"`<br>}<br><br>func main() {<br>    t := reflect.TypeOf(Person{})<br>    field := t.Field(0) // 获取第一个字段 Name<br><br>    jsonTag := field.Tag.Get("json")<br>    xmlTag := field.Tag.Get("xml")<br><br>    fmt.Println("JSON tag:", jsonTag) // 输出: full_name<br>    fmt.Println("XML tag:", xmlTag)   // 输出: name<br>}

登录后复制

Tag.Get(key) 方法用于提取指定键的标签值，是处理结构体标签的核心方式。