如何利用Golang反射解析JSON标签_Golang reflect标签读取与映射逻辑

风雪大大_8907

风雪大大_8907

2025-12-07

552人浏览

原创

JSON标签是结构体字段的元信息,由encoding/json包通过反射读取;手动解析需用reflect获取tag值并按“name,option”格式拆分处理,注意导出字段限制和常见选项语义。

如何利用golang反射解析json标签_golang reflect标签读取与映射逻辑

Go 语言中,json 标签本身不参与运行时逻辑,它只是结构体字段的元信息;真正读取和利用这些标签的是 encoding/json 包内部的反射逻辑。要手动解析 JSON 标签(比如做自定义序列化、字段校验、API 文档生成等),你需要用 reflect 包提取结构体字段的 json 标签值,并按规则解析其内容。

获取结构体字段的 json 标签值

通过 reflect.TypeOf 获取结构体类型,再遍历每个字段,调用 Field(i).Tag.Get("json") 即可拿到原始标签字符串。注意:必须使用导出字段(首字母大写),非导出字段无法被反射访问。

例如:

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

t := reflect.TypeOf(User{})
for i := 0; i ", tag)
}

解析 json 标签的语义(名称 + 选项)

JSON 标签格式为 "name,option1,option2",其中:

  • 逗号前是序列化后的字段名(空则默认用字段名)
  • omitempty 表示零值字段不输出
  • - 表示该字段完全忽略(跳过编解码)
  • 其他选项(如 string)由 json 包解释,反射层不处理

你可以手动拆分并判断:

JSON Toolkit
JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载
func parseJSONTag(tag string) (name string, omitEmpty bool, ignored bool) {
    if tag == "-" {
        return "", false, true
    }
    parts := strings.Split(tag, ",")
    name = parts[0]
    if name == "" {
        name = "default_name" // 实际中可用 field.Name 替代
    }
    for _, opt := range parts[1:] {
        if opt == "omitempty" {
            omitEmpty = true
        }
    }
    return
}

映射 JSON 字段名回结构体字段(反向查找)

若你有一个 JSON 键名(如 "user_name"),想找到对应结构体字段,需遍历所有字段,解析其 json 标签,比对名称:

  • 若标签名匹配,则命中
  • 若标签为空或未设,回退到字段名(需转成小写或 snake_case?注意:标准库默认用原字段名,且首字母大写 → 首字母小写)
  • 忽略 - 字段

注意:标准 json.Unmarshal 的字段匹配逻辑更复杂(支持大小写不敏感、嵌套别名等),但自定义场景下只需基础映射即可。

常见陷阱与注意事项

  • 反射无法读取未导出字段的标签(小写字母开头字段永远不可见)
  • Tag.Get("json") 返回空字符串不代表没标签,可能是 json:"",需额外判断
  • 标签中的空格不会被自动 trim,建议解析时 strings.TrimSpace
  • 嵌套结构体需递归处理,reflect.Kind() 判断是否为 struct
  • 不要在热路径频繁用反射,可考虑启动时缓存解析结果(如构建字段名 ↔ JSON 名映射表)

基本上就这些。掌握 reflect.StructTag 和手动解析逻辑,就能灵活支撑序列化增强、ORM 映射、OpenAPI 生成等场景。不需要魔改标准库,靠几行反射 + 字符串处理就能复刻核心行为。

golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json golang 标准库

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

539

5

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

616

5

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

1316

5

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.05

811

5

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.05.21

1926

6

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

5494

18

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

2025.06.10

2554

13

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

2025.06.17

4406

17

golang数组大全
golang数组大全

本专题整合了golang数组相关问题解决方法,想了解更多相关内容,请阅读下面的文章。

2025.06.20

5766

22

热门下载

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

精品课程

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

共101课时 | 21.4万人学习

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

共39课时 | 4.9万人学习