StructTag解析错误因标签格式不对，必须用反引号包裹如json:"name"；嵌套结构体和指针需手动递归解引用并判空；反射前须检查field.IsValid()&&field.CanInterface()，否则panic。
为什么 reflect.StructTag 解析不对，字段总被忽略？
结构体转 Map 时字段消失，八成是标签没写对。Go 的 reflect.StructTag 不认任意字符串，必须用 `json:"name"` 这种格式，且引号得是反引号（`），不是单引号或双引号。
- 常见错误：
json:'user_id'（单引号）、json:"user_id"（双引号但没包在反引号里）→StructTag.Get("json")返回空 - 如果想支持多标签（比如同时兼容
json和db），得显式指定，比如tag := field.Tag.Get("json")，不会自动 fallback - 空标签（
json:"-"）或带omitempty的字段，要手动判断：若tag == "-" || strings.Contains(tag, "omitempty")，通常跳过序列化更安全
嵌套结构体和指针字段怎么递归处理？
反射走到 struct 或 *struct 类型时，不主动展开，得自己判断并递归调用。直接 field.Interface() 拿到的是接口值，不是底层结构体；如果是 nil 指针，Interface() 会 panic。
- 先用
field.Kind()判断是否为reflect.Struct或reflect.Ptr - 如果是
reflect.Ptr，先检查field.IsNil()，nil 就跳过或填nil（取决于业务需求） - 非 nil 指针需用
field.Elem()取出实际值，再判断是否为 struct；否则递归进去会卡在指针类型上 - 切片、map 类型同理：需区分
reflect.Slice和reflect.Map，不能一概转 map[string]interface{}
reflect.Value.Interface() panic：“call of reflect.Value.Interface on zero Value”
这个错误只说明你对一个无效的 reflect.Value 调用了 Interface()，最常见于：访问了不存在的字段、用 FieldByName 找不到字段后没检查有效性、或对未导出字段强行取值（Go 反射无法读私有字段）。
- 永远在
FieldByName后加isValid := field.IsValid() && field.CanInterface()判断 - 结构体字段名首字母小写 → 反射不可见 →
field.IsValid()为 false，此时别硬转，跳过或报错提示“字段未导出” - 用
field.Type().Name()查字段类型名时，注意指针类型返回的是"*T"，不是"T"，别拿它直接做 switch
性能敏感场景下，为什么别在热路径反复用反射？
每次 reflect.TypeOf + reflect.ValueOf 都有分配和类型检查开销，实测比手写 map 构造慢 5–20 倍，GC 压力也明显上升。反射适合配置驱动、低频调用的通用逻辑（如 API 统一响应包装），不适合高频日志打点或内部数据流转。
立即学习“go语言免费学习笔记（深入）”；
- 若结构体固定，优先生成代码（用
go:generate+golang.org/x/tools/go/packages）提前把转换逻辑写死 - 若必须运行时反射，至少缓存
reflect.Type和字段信息（用sync.Map存map[reflect.Type]*fieldInfo） - 注意：
reflect.Value本身不能跨 goroutine 共享，缓存时只缓存Type和字段索引，别缓存Value
字段标签解析、指针解引用、无效值检查这三步漏掉任何一环，Map 就会丢数据或 panic —— 不是反射难，是它不替你做防御性假设。
