struct tags在go语言中用于定义结构体字段的元信息,主要控制数据序列化与反序列化行为。1. json标签通过指定字段名和omitempty选项影响json键名及零值处理;2. xml标签支持元素、属性映射并包含特殊语法如attr和chardata;3. 其他常见标签包括yaml、db、form和validate,分别用于yaml解析、数据库映射、表单解析及字段校验;4. 使用时需注意标签格式合法性、选项分隔符及库间差异,建议使用工具检查错误。

在Go语言中,struct tags 是结构体字段后附加的元信息,用来指导某些库(如 encoding/json、encoding/xml)如何处理这些字段。它们不会影响程序的运行逻辑,但对数据序列化和反演非常关键。

JSON标签:控制字段名称与行为
当你用 json.Marshal 或 json.Unmarshal 时,json 标签决定了字段如何映射到JSON键名。

格式如下:
立即学习“go语言免费学习笔记(深入)”;
Field string `json:"tag_name,omitempty"`
-
"tag_name"指定JSON中的字段名。 -
omitempty表示如果字段为零值,则在序列化时忽略该字段。 - 如果不加标签,默认使用字段名小写作为键名。
- 特殊标签
-可以完全跳过字段。
例如:

type User struct {
Name string `json:"username"`
Age int `json:"age,omitempty"`
Token string `json:"-"`
}这样序列化出来的JSON会是:
{
"username": "Alice",
"age": 30
}即使 Token 字段有值也不会出现。
XML标签:类似但略有不同
XML标签也用于控制结构体字段与XML元素之间的映射,不过语法稍微复杂一些。
基本格式:
Field string `xml:"tag_name,attr"`
常见选项包括:
-
attr:表示该字段作为属性而不是子元素。 -
chardata:字段内容直接作为文本节点。 -
innerxml:允许自定义嵌套的XML片段。
示例:
type Book struct {
Title string `xml:"title"`
Author string `xml:"author,omitempty"`
ISBN string `xml:"isbn,attr"`
}对应的XML可能是:
Go Programming Alice
注意:XML标签对大小写敏感,且结构更严格,需要匹配实际的XML结构。
其他常见标签及用途
除了 json 和 xml,还有其他一些常用的结构体标签:
- yaml:用于YAML格式解析,格式与JSON类似。
- db:常用于ORM框架,比如GORM,指定数据库列名。
- form:用于解析HTTP表单数据。
-
validate:用于字段校验,比如
validate:"required"
例如:
type Product struct {
ID int `db:"product_id" json:"id"`
Name string `json:"name" form:"product_name" validate:"required"`
Price float64 `json:"price,omitempty" db:"price"`
}这些标签虽然不是语言内置功能,但被广泛支持于各种流行库中,极大地提升了结构体与外部数据格式之间的互操作性。
注意事项和技巧
使用struct tags时要注意以下几点:
- 标签名必须是合法的Go字符串,不能有空格,除非用引号包裹。
- 多个选项之间用逗号分隔。
- 使用工具如
go vet可以检查标签拼写错误。 - 不同库可能对标签的处理方式略有不同,建议查阅对应文档。
基本上就这些。struct tags看起来简单,但在实际开发中非常实用,尤其是在处理多种数据格式时,能大大简化代码逻辑。










