讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

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

梦婷小哥_7136

梦婷小哥_7136

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

|

934人浏览过

|

来源于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 标签:

Expanso yaml-to-json
Expanso yaml-to-json

使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载
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 库和框架的基础能力。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

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

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

2335

2023.08.07

json是什么
json是什么

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

3842

2023.08.23

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

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

1276

2023.10.13

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

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

4479

2025.09.10

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

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

5164

2024.04.01

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

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

6697

2024.08.01

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

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

2642

2024.11.28

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

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

1938

2023.08.03

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

40

2026.11.12

热门下载

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

精品课程

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

共101课时 | 21.4万人学习

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

共39课时 | 4.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn