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

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

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

2025-12-07

浏览次数：次

返回列表

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 < t.NumField(); i++ {
    field := t.Field(i)
    tag := field.Tag.Get("json") // 返回 "id"、"name,omitempty"、"email"、"-"
    fmt.Println(field.Name, "->", tag)
}

解析 json 标签的语义（名称 + 选项）

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

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

你可以手动拆分并判断：

AdMaker AI

从0到爆款高转化AI广告生成器

65 查看详情 AdMaker AI

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
}