golang结构体tag的使用小结

更新时间：2026年03月02日 10:27:33 作者：gopher.guo

本文主要介绍了golang结构体tag的使用小结,Tag用于序列化、表单绑定、校验和数据库映射等,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

🧠 一、什么是结构体 Tag？

在 Go 中，结构体字段可以有额外的元信息，称为 Tag（标签）。这些信息通常用于：

序列化（如 json, xml, yaml）
表单绑定（如 form)
校验（如 validate)
数据库映射（如 gorm, xorm）

Tag 写在结构体字段名的后面，用 反引号 ``` 包裹。

🧱 二、结构体 Tag 的基本语法

type StructName struct {
    FieldName FieldType `tagKey:"tagValue"`
}

💡 多个 tag 用 空格隔开，例如：

FieldName string `json:"name" xml:"name" validate:"required"`

🧩 三、图示讲解结构体 tag 组成

type User struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Email string `json:"email,omitempty"`
    Age   int    `json:"-"`             // 不序列化
}

字段名	类型	Tag 字符串	含义
ID	int	json:"id"	JSON 输出为 id
Name	string	json:"name"	JSON 输出为 name
Email	string	json:"email,omitempty"	如果为零值则不输出
Age	int	json:"-"	永远忽略，不输出

📦 四、实战场景演示

✅ 示例1：JSON 序列化

package main

import (
    "encoding/json"
    "fmt"
)

type User struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Email string `json:"email,omitempty"`
    Age   int    `json:"-"`
}

func main() {
    user := User{ID: 1001, Name: "李雷", Email: "", Age: 30}
    result, _ := json.Marshal(user)
    fmt.Println(string(result)) // 输出：{"id":1001,"name":"李雷"}
}

🔍 为什么只有 ID 和 Name？

Email 为空，使用了 omitempty
Age 被忽略，使用了 "-"

✅ 示例2：GORM 中的数据库映射 tag

type Product struct {
    ID    int    `gorm:"primaryKey;autoIncrement" json:"id"`
    Name  string `gorm:"type:varchar(100);not null" json:"name"`
    Price int    `gorm:"column:product_price" json:"price"`
}

tag 类型	示例内容	说明
gorm	primaryKey, type, column	表示数据库字段特性
json	json:"name"	表示 JSON 序列化字段名

✅ 示例3：表单解析 + 校验 tag

type LoginForm struct {
    Username string `form:"username" json:"username" binding:"required"`
    Password string `form:"password" json:"password" binding:"required,min=6"`
}

tag	用法
form	表单字段绑定，例如 HTTP POST 请求
json	JSON 请求体解析
binding	验证字段，如 required, min=6 等

🧪 五、如何读取 Tag？

通过反射（reflect）读取结构体字段的 tag。

import (
    "fmt"
    "reflect"
)

type Person struct {
    Name string `json:"name" label:"姓名"`
}

func main() {
    t := reflect.TypeOf(Person{})
    field := t.Field(0)

    fmt.Println("json tag:", field.Tag.Get("json"))  // 输出 name
    fmt.Println("label tag:", field.Tag.Get("label"))// 输出 姓名
}

🧠 六、tag 使用建议

建议	原因
❗避免乱写	tag 格式要正确，例如反引号必须成对
✅ 多 tag 用空格分隔	保持清晰易读
🧪 可以结合反射动态读取 tag	做校验、自动映射等功能
🔐 不要暴露敏感字段到 JSON 中	使用 `json:"-"`

🎁 七、可视化图（结构体 tag 工作流程）

+-------------------+
| struct 定义       |
|-------------------|
| Name string       |
|      `json:"name"`| ----->  序列化 JSON 输出字段 "name"
+-------------------+

到此这篇关于golang结构体tag的使用小结的文章就介绍到这了,更多相关golang结构体tag内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

解决golang结构体tag编译错误的问题

Golang中的sync包的WaitGroup操作
这篇文章主要介绍了Golang中的sync包的WaitGroup操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-04-04
GoFrame框架gredis优雅的取值和类型转换
这篇文章主要为大家介绍了GoFrame框架gredis优雅的取值和类型转换，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-06-06
golang定时器和超时的使用详解
这篇文章主要介绍了golang定时器和超时的使用详解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-12-12
Go标准库常见错误分析和解决办法
Go语言的标准库为开发者提供了丰富且高效的工具,涵盖了从网络编程到文件操作等各个方面,然而,标准库虽好,使用不当却可能适得其反,正所谓"工欲善其事,必先利其器",本文将深入剖析Go标准库使用中的常见错误,帮助开发者避开这些坑,写出更加健壮的代码
2025-04-04
详解Go语言中for循环,break和continue的使用
这篇文章主要通过一些示例为大家介绍一下Go语言中for循环、break和continue的基本语法以及使用，文中的示例代码讲解详细，感兴趣的小伙伴可以了解一下
2022-06-06
go实现脚本解释器gscript
这篇文章主要为大家介绍了go实现脚本解释器gscript示例代码，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-07-07
Golang中的结构体和反射示例详解
文章介绍了Go语言中结构体的使用、结构体与JSON数据的转换以及反射机制,反射允许在运行时获取类型信息、动态调用方法、访问属性和构造对象,文章还提到了使用reflect包来获取和操作结构体的字段、方法、类型和值,本文结合实例代码介绍的非常详细,感兴趣的朋友一起看看吧
2025-10-10
用go gin server来做文件上传服务
今天小编就为大家分享一篇关于用go gin server来做文件上传服务，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2019-04-04
详解以go思想去处理js异常抛弃trycatch
这篇文章主要为大家介绍了详解以go思想去处理js异常抛弃trycatch，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-03-03
Go语言学习函数+结构体+方法+接口
这篇文章主要介绍了Go语言学习函数+结构体+方法+接口，文章围绕主题的相关资料展开详细的文章说明，具有一定的参考价值，需要的小伙伴可以参考一下
2022-05-05