因为 reflect.StructField.Tag 是 reflect.StructTag 类型，需调用 Tag.Get("key") 才能解析并提取值；直接访问或打印 field.Tag 会输出空字符串或乱码，且标签语法错误或键不存在时 Get 返回空而不 panic。
Go 的反射能读取结构体字段的 struct 标签，但必须通过 reflect.StructField 的 Tag 字段，且标签值需用 Get 方法提取 —— 直接访问 Tag 是空字符串。
为什么 field.Tag 看起来是空的？
因为 reflect.StructField.Tag 是 reflect.StructTag 类型（本质是字符串），它不支持直接打印或比较；必须调用 Tag.Get("key") 才能安全提取值。直接写 fmt.Println(field.Tag) 会输出空字符串或乱码。
-
Tag内部做了 key-value 解析缓存，未调用Get就不会解析 - 若标签不存在（如
json但结构体没写`json:"name"`），Tag.Get("json")返回空字符串，不会 panic - 标签语法错误（比如引号不闭合）会导致
Get返回空，且无提示 —— 这是常见静默失败点
如何安全读取 json 或 db 等常用标签？
先获取结构体类型，再遍历字段，对每个 StructField 调用 Tag.Get("xxx")：
type User struct {
ID int `json:"id" db:"user_id"`
Name string `json:"name" db:"user_name"`
}
t := reflect.TypeOf(User{})
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
jsonTag := field.Tag.Get("json") // → "id" 或 "name"
dbTag := field.Tag.Get("db") // → "user_id" 或 "user_name"
fmt.Printf("%s: json=%q, db=%q\n", field.Name, jsonTag, dbTag)
}
- 标签 key 区分大小写：
Tag.Get("JSON")和Tag.Get("json")不等价 - 如果字段是嵌套匿名结构体，需递归调用
Field(i).Type判断是否为struct并深入 -
Tag.Get对任意字符串 key 都返回字符串，即使 key 完全不存在 —— 不要依赖非空判断来确认标签存在
如何处理带选项的标签，比如 json:"name,omitempty"？
Tag.Get("json") 返回完整值（如 "name,omitempty"），需手动解析。标准库提供 strings.Split 或正则，但更稳妥的是复用 Go 自身的解析逻辑：
立即学习“go语言免费学习笔记（深入）”；
import "strings"
func parseJSONTag(tag string) (name string, opts []string) {
if idx := strings.Index(tag, ","); idx > 0 {
name, opts = tag[:idx], strings.Split(tag[idx+1:], ",")
} else {
name = tag
}
return
}
// 使用：
jsonTag := field.Tag.Get("json")
if jsonTag != "" {
name, opts := parseJSONTag(jsonTag)
hasOmitEmpty := slices.Contains(opts, "omitempty") // Go 1.21+
}
- 不要自己写正则匹配带引号的字段名 ——
json:"user\"name"这类合法转义会让正则崩溃 -
encoding/json包内部用的是structTag类型的私有方法，外部无法复用，所以手动切分最可控 - 注意：空格在标签值中是允许的（如
json:" id ,omitempty"），但标准库会忽略首尾空格 —— 若需严格一致，自行strings.TrimSpace
反射读标签本身开销不大，但频繁在热路径调用 reflect.TypeOf 会触发运行时类型查找，建议把标签解析结果缓存到 map 或结构体外变量中；另外，Tag 只对导出字段（大写开头）有效，小写字段的标签在反射中不可见。
