go 语言通过 reflect 包解析 Struct tag 提取元信息，需遵循 key:"value" 格式规则并用 Tag.Get 或 Tag.Lookup 安全提取；错误写法如单引号、多余空格或重复 key 会导致解析失效。
Go 语言的反射（reflect）包支持通过结构体字段的 struct tag 提取元信息，常用于序列化（如 jsON、xml）、校验、ORM 映射等场景。关键在于正确书写 tag 字符串，并用 reflect.StructTag.Get 或 reflect.StructField.Tag.Lookup 安全提取值。
struct tag 的基本格式规则
每个字段的 tag 是一个反引号包裹的字符串，由多个 key:"value" 对组成，用空格分隔：
- key 必须是纯 ASCII 字母或下划线，不能含空格、冒号、引号或 Unicode 字符
- value 必须用双引号包裹（不能用单引号或反引号），内部可使用转义（如
"a"b"） - 同一个 key 出现多次时，以最后一个为准（Go 不报错但会覆盖）
- 不合法的 tag（如缺少引号、引号不匹配）会导致编译通过但运行时
Tag.Get返回空字符串
安全提取 tag 值的两种推荐方式
不要直接操作 tag 字符串。应使用标准库提供的解析方法：
-
field.Tag.Get("json")：返回对应 key 的 value，未找到则返回空字符串 -
field.Tag.Lookup("json")：返回(value String, ok bool)，更明确地区分“不存在”和“值为空” - 避免手动
strings.Split或正则解析 —— tag 内部可能含空格或转义，标准解析器已处理所有边界情况
常见实战误区与修复示例
以下写法看似合理，实则无效或危险：
立即学习“go语言免费学习笔记（深入）”；
-
json:"name,omitempty" db:"user_name"✅ 正确：两个独立 key，空格分隔 -
json:"name, omitempty"❌ 错误：逗号后多空格，JSON 解析器会把整个值当字段名（如"name, omitempty"），而非启用 omitempty -
json:'name'❌ 错误：用了单引号，编译不报错但Get("json")返回空 -
json:"name,omitempty" json:"id"⚠️ 警告：后一个覆盖前一个，最终只生效json:"id"
完整可运行示例：解析 JSON 和自定义 tag
下面代码演示如何获取并判断字段是否被标记为忽略（omitempty）、是否有别名、以及是否存在自定义验证 tag：
type User struct { ID int `json:"id"` Name string `json:"name,omitempty" validate:"required,min=2"` Age int `json:"age" validate:"gte=0,lte=150"` } func inspectTags() { t := reflect.TypeOf(User{}) for i := 0; i < t.NumField(); i++ { f := t.Field(i) fmt.Printf("字段: %sn", f.Name) if jsonTag, ok := f.Tag.Lookup("json"); ok { fmt.Printf(" JSON tag: %qn", jsonTag) // 如 "id", "name,omitempty" if strings.Contains(jsonTag, "omitempty") { fmt.Println(" → 启用 omitempty") } } if vTag, ok := f.Tag.Lookup("validate"); ok { fmt.Printf(" Validate tag: %qn", vTag) } } }
基本上就这些。tag 规则不复杂但容易忽略细节，坚持用 Lookup 判空、严格按格式书写，就能稳定支撑各类元编程需求。