0

0

Go 语言中结构体字段标签(Struct Tags)的使用详解

碧海醫心

碧海醫心

发布时间:2026-01-05 11:53:50

|

914人浏览过

|

来源于php中文网

原创

Go 语言中结构体字段标签(Struct Tags)的使用详解

结构体字段标签是附加在字段上的元数据字符串,用于为序列化、验证、数据库映射等提供配置信息;它们本身不参与运行时逻辑,需通过反射(`reflect` 包)读取和解析,常见于 `json`、`xml`、`gorm` 等标准库与第三方库中。

在 Go 中,结构体字段标签(struct tags)是以反引号包裹的字符串,紧跟在字段类型之后,语法形式为:`key:"value" key2:"value2"`。例如:

type User struct {
    Name  string `json:"name" xml:"name" validate:"required"`
    Email string `json:"email" xml:"email" validate:"email"`
    Age   int    `json:"age,omitempty" xml:"age"`
}

这里的 json:"name"、xml:"name" 和 validate:"required" 都是字段标签,每个标签由一个键(key) 和一个带引号的值(value) 组成,多个键值对以空格分隔。注意:标签内容不会被编译器检查或执行——它纯粹是供运行时反射读取的字符串。

要访问字段标签,必须使用 reflect 包。以下是一个完整示例,演示如何获取并解析 json 标签:

Transor
Transor

专业的AI翻译工具,支持网页、字幕、PDF、图片实时翻译

下载
package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name  string `json:"name" db:"user_name"`
    Email string `json:"email"`
}

func main() {
    u := User{}
    t := reflect.TypeOf(u)

    // 遍历结构体所有字段
    for i := 0; i < t.NumField(); i++ {
        field := t.Field(i)
        fmt.Printf("字段名: %s\n", field.Name)

        // 获取 json 标签值
        jsonTag := field.Tag.Get("json")
        fmt.Printf("  json 标签: %q\n", jsonTag) // 输出: "name", "email"

        // 获取自定义 db 标签
        dbTag := field.Tag.Get("db")
        fmt.Printf("  db 标签: %q\n", dbTag) // 输出: "user_name", ""
    }
}

⚠️ 重要注意事项

  • 字段必须是导出的(首字母大写),否则 reflect 无法访问其标签(未导出字段的 Tag 返回空字符串);
  • 标签值中的双引号必须是字面量双引号,且整个标签必须用反引号包裹(不能用双引号),否则编译报错;
  • field.Tag.Get(key) 是安全获取方式:若键不存在,返回空字符串,不会 panic;
  • 标签解析逻辑由各库自行实现(如 encoding/json 解析 json 标签,gorm.io/gorm 解析 gorm 标签),Go 语言本身不内置任何标签语义;
  • 不要将业务逻辑耦合到标签中——标签应仅作为声明式配置,避免滥用(如嵌入复杂表达式或逻辑)。

总结来说,结构体标签是 Go 实现“约定优于配置”的关键机制之一:它让结构体既能保持简洁干净,又能灵活支持多种序列化、校验、持久化场景。掌握 reflect.StructTag 的使用,是编写可扩展 Go 库和框架的基础能力。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

404

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

531

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

308

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1859

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2082

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

942

2024.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

253

2023.08.03

深入理解算法:高效算法与数据结构专题
深入理解算法:高效算法与数据结构专题

本专题专注于算法与数据结构的核心概念,适合想深入理解并提升编程能力的开发者。专题内容包括常见数据结构的实现与应用,如数组、链表、栈、队列、哈希表、树、图等;以及高效的排序算法、搜索算法、动态规划等经典算法。通过详细的讲解与复杂度分析,帮助开发者不仅能熟练运用这些基础知识,还能在实际编程中优化性能,提高代码的执行效率。本专题适合准备面试的开发者,也适合希望提高算法思维的编程爱好者。

1

2026.01.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.1万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号