如何在 Go 中通过反射获取结构体字段的标签值

本文介绍如何使用 Go 的 reflect 包读取结构体字段上的自定义标签（如 json:"name"），并通过 StructTag.Get() 方法提取指定键的值，适用于序列化、校验、ORM 映射等场景。

本文介绍如何使用 Go 的 reflect 包读取结构体字段上的自定义标签（如 `json:"name"`），并通过 `StructTag.Get()` 方法提取指定键的值，适用于序列化、校验、ORM 映射等场景。

在 Go 语言中，结构体字段标签（struct tags）是附加在字段声明后的反引号字符串，常用于控制 JSON、XML 序列化行为（如 json:"user_name,omitempty"）。但这些标签并非仅限标准库使用——开发者也可定义自己的标签键（如 validate:"required" 或 db:"id"），并在运行时通过反射机制动态读取和解析。

核心步骤如下：

1. 获取结构体类型的 reflect.Type；
2. 通过 Field(i) 获取指定字段的 StructField；
3. 调用 field.Tag.Get("key") 提取对应标签值（若不存在则返回空字符串）。

以下是一个完整示例：

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name  string `json:"name" validate:"required" db:"username"`
    Email string `json:"email" validate:"email" db:"email_addr"`
}

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)
        fmt.Printf("  JSON 标签: %s\n", field.Tag.Get("json"))
        fmt.Printf("  校验规则: %s\n", field.Tag.Get("validate"))
        fmt.Printf("  数据库列名: %s\n", field.Tag.Get("db"))
        fmt.Println()
    }
}

输出结果：

字段: Name
  JSON 标签: name
  校验规则: required
  数据库列名: username

字段: Email
  JSON 标签: email
  校验规则: email
  数据库列名: email_addr

⚠️ 注意事项：

• 标签字符串必须用反引号（`）包裹，双引号会导致编译错误；
• reflect.StructTag 内部按空格分割多个键值对，每个键值对格式为 "key:\"value\""，且 key 必须为 ASCII 字母或下划线；
• Tag.Get(key) 对大小写敏感，且不支持嵌套或复杂语法（如需高级解析，可结合第三方库如 github.com/mitchellh/mapstructure 或自行实现解析器）；
• 反射操作有运行时开销，建议缓存 reflect.Type 和字段信息（例如在 init() 函数中预处理），避免高频重复调用。

掌握结构体标签的反射访问能力，是构建通用工具（如配置绑定、API 参数校验、轻量 ORM）的关键基础。合理封装标签读取逻辑，可显著提升代码复用性与扩展性。