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 字符串含义
IDintjson:"id"JSON 输出为 id
Namestringjson:"name"JSON 输出为 name
Emailstringjson:"email,omitempty"如果为零值则不输出
Ageintjson:"-"永远忽略,不输出

📦 四、实战场景演示

✅ 示例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 类型示例内容说明
gormprimaryKey, type, column表示数据库字段特性
jsonjson:"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 请求
jsonJSON 请求体解析
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文件操作增删改查功能(基础篇)

    一文搞懂Golang文件操作增删改查功能(基础篇)

    这篇文章主要介绍了一文搞懂Golang文件操作增删改查功能(基础篇),Golang 可以认为是服务器开发语言发展的趋势之一,特别是在流媒体服务器开发中,已经占有一席之地,今天我们不聊特别深奥的机制和内容,就来聊一聊 Golang 对于文件的基本操作
    2021-04-04
  • golang中对

    golang中对"引用传递"的误解

    这篇文章主要介绍了golang中对“引用传递”的误解,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-06-06
  • Golang中crypto/ecdsa库实现数字签名和验证

    Golang中crypto/ecdsa库实现数字签名和验证

    本文主要介绍了Golang中crypto/ecdsa库实现数字签名和验证,将从ECDSA的基本原理出发,详细解析如何在Go语言中实现数字签名和验证,具有一定的参考价值,感兴趣的可以了解一下
    2024-02-02
  • 谈论Go 什么时候会触发 GC问题

    谈论Go 什么时候会触发 GC问题

    Go 语言作为一门新语言,在早期经常遭到唾弃的就是在垃圾回收(下称:GC)机制中 STW(Stop-The-World)的时间过长。下面文章就对此话题展开,感兴趣的小伙伴可以参考下面文章的内容
    2021-09-09
  • GO 反射对性能的影响分析

    GO 反射对性能的影响分析

    这篇文章主要为大家介绍了GO 反射对性能的影响分析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-01-01
  • Golang错误处理方式异常与error

    Golang错误处理方式异常与error

    我们在使用Golang时,不可避免会遇到异常情况的处理,与Java、Python等语言不同的是,Go中并没有try...catch...这样的语句块,这个时候我们如何才能更好的处理异常呢?本文来教你正确方法
    2023-01-01
  • Go prometheus metrics条目自动回收与清理方法

    Go prometheus metrics条目自动回收与清理方法

    这篇文章主要为大家介绍了Go prometheus metrics条目自动回收与清理方法详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-11-11
  • golang 如何通过反射创建新对象

    golang 如何通过反射创建新对象

    这篇文章主要介绍了golang 通过反射创建新对象的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-04-04
  • Golang实现组合模式和装饰模式实例详解

    Golang实现组合模式和装饰模式实例详解

    这篇文章主要介绍了Golang实现组合模式和装饰模式,本文介绍组合模式和装饰模式,golang实现两种模式有共同之处,但在具体应用场景有差异。通过对比两个模式,可以加深理解,需要的朋友可以参考下
    2022-11-11
  • 用Go快速上手Protocol Buffers详解

    用Go快速上手Protocol Buffers详解

    Protobuf是一种高效的跨语言序列化协议,适用于Go语言,本文介绍了如何安装和使用Protobuf,包括定义协议、生成Go代码、序列化和反序列化,以及版本演进和兼容性,通过一个完整的示例,展示了如何在Go项目中使用Protobuf
    2025-11-11

最新评论