field.Tag.Get("json") panic 的根本原因是 field.Tag 是 string 类型，必须通过 reflect.StructField 获取才能作为 reflect.StructTag 调用 Get()；正确写法仅限 field 来自 reflect.TypeOf(t).Field(i)，否则会 panic。
field.Tag.Get("json") panic 是最常见的误用
直接对 field.Tag 调用 .Get() 会编译失败或 panic，因为 field.Tag 是 string 类型，不是 reflect.StructTag。Go 的反射机制把标签原始字符串（如 `json:"name,omitempty"`）存为 string，但只有显式转成 reflect.StructTag 才能调用 .Get() —— 而这个转换是隐式发生的：只要你是通过 reflect.StructField 拿到的 Tag 字段，它在运行时就是 reflect.StructTag 类型。
正确写法只有一种：field.Tag.Get("json")，前提是 field 确实来自 reflect.TypeOf(t).Field(i)。常见错误包括：
- 误写成
field.Tag.Get前漏掉field，比如直接Tag.Get - 把结构体指针传给
reflect.TypeOf后没调用.Elem()，导致拿到的是*T类型而非T，NumField()返回 0 - 字段未导出（首字母小写），
reflect无法访问，Field()返回空StructField
解析 json:"name,omitempty" 时怎么提取干净字段名
field.Tag.Get("json") 返回的是完整字符串，比如 "user_name,omitempty" 或 "-"，不能直接当 key 用。你需要手动拆解，标准库不提供现成函数。
推荐做法是用 strings.SplitN(tagValue, ",", 2) 取第一段，再 strings.TrimSpace() 清理空格，并检查是否为 "-"：
立即学习“go语言免费学习笔记（深入）”；
jsonTag := field.Tag.Get("json")
if jsonTag == "" {
jsonTag = field.Name // fallback to field name
} else {
parts := strings.SplitN(jsonTag, ",", 2)
jsonTag = strings.TrimSpace(parts[0])
if jsonTag == "-" {
continue // skip this field
}
}
注意：不要用 strings.Split(tagValue, ",")，避免字段名本身含逗号（虽罕见但合法）；也不要忽略 omitempty 后缀的存在——它不影响字段名提取，只影响序列化逻辑。
嵌套结构体和匿名字段的标签会被跳过
默认调用 t.NumField() 只遍历顶层字段。如果结构体包含匿名字段（比如 type User struct { Person }），它的字段不会自动出现在 Field(i) 中，除非你手动递归处理。
关键判断点是 field.Anonymous：
- 为
true时，该字段是内嵌结构体，需递归调用解析函数 - 递归前必须检查循环引用，比如 A 包含 B，B 又包含 A，否则栈溢出
- 内嵌字段若自身有
json标签，则优先使用该标签；若没有，且外层字段名与内嵌字段名相同，Go 不会自动“提升”标签，也不会合并，此时Tag.Get("json")返回空字符串
简单策略：遇到 field.Anonymous && field.Type.Kind() == reflect.Struct 就进递归，同时用 map[reflect.Type]bool 记录已处理类型防重复。
高频场景下反射 + 标签解析会拖慢吞吐
在 HTTP handler、gRPC 方法或数据库扫描循环里反复调用 reflect.TypeOf(x) 和遍历字段，开销不可忽视。一次反射调用比普通函数调用慢 10–100 倍，尤其当结构体字段多、嵌套深时。
实际优化手段很有限，但有效：
- 用
sync.Map缓存reflect.Type到字段映射的结构，键建议用t.String()（比unsafe.Pointer更安全） - 避免在 for 循环里重复调用
reflect.ValueOf(x).Type()，提前提取并复用 - 如果结构体固定（如 ORM 实体、API 请求体），生成代码替代运行时反射，比如用
go:generate配合ast包提前解析标签
最易被忽略的一点：缓存失效难处理。一旦结构体定义变更，缓存可能 stale，而 Go 没有类型版本号机制，靠 t.String() 也不完全可靠 —— 这意味着上线前必须清空缓存或加校验逻辑。
