reflect.structtag解析失败的根本原因是未确保操作对象为结构体字段，如传入*mystruct需先v.elem()；标签须用反引号包裹且字段必须可导出。
为什么 reflect.StructTag 解析失败？
常见现象是用 structTag.Get("json") 拿不到字段名，返回空字符串。根本原因不是标签写错了，而是没调用 field.Type.Kind() == reflect.Struct 前就直接取 tag——reflect.StructTag 只对结构体字段有效，而反射对象可能是指针、接口或嵌套值。
- 确保操作的是
reflect.Value 的 Elem() 后的字段（比如传入的是 *MyStruct，得先 v.Elem() 再遍历）
- 标签必须用反引号包裹：
json:"user_name,omitempty"，双引号会编译报错
- 若字段是导出的（首字母大写），但 struct 本身未导出，反射无法访问其字段，会静默跳过
map[string]interface{} 转结构体时 panic: reflect.Set: value of type map[string]interface{} is not assignable to type XXX
这是最常卡住的地方：想用 reflect.Value.Set() 直接把 map 值塞进 struct 字段，但类型不匹配。Go 反射不允许跨类型赋值，哪怕内容看起来能转。
- 必须逐字段处理：从 map 中取出
interface{} 值，再按目标字段类型做显式转换（比如 int64 ← float64、string ← []byte）
- 时间字段特别容易翻车：
time.Time 不能直接从 string 或 int64 赋值，得用 time.Parse 或 time.Unix
- 嵌套结构体要递归处理，别忘了检查
field.CanSet() && field.CanAddr()，否则 Set() 会 panic
性能差到不敢上生产？别直接用 reflect.Value.Interface() 回填 map
每次调用 Interface() 都触发一次内存分配和类型擦除，尤其在高频请求中，GC 压力明显。这不是“慢一点”，是量级差异。
- 对 map → struct，优先用代码生成（如
easyjson 或 msgp）替代运行时反射
- 如果必须用反射，缓存
reflect.Type 和字段索引（用 sync.Map 存 map[reflect.Type][]fieldInfo），避免每次重复 reflect.TypeOf().NumField()
- 字段名映射别每次都
strings.ToLower()，提前建好小写 key 到字段索引的 map
nil 指针、空 slice、零值字段在互转时怎么保留原意？
默认反射行为会把 nil slice 当成空 slice，把未设置的 struct 字段当成零值，但业务里“未提供”和“明确设为空”语义不同。
- map → struct 时，用
map 是否含 key 判断字段是否应被赋值，而不是依赖字段当前值
- struct → map 时，对指针字段，检查
!v.IsNil()；对 slice，检查 v.Len() == 0 && v.IsNil() 才算 truly empty
-
omitempty 标签只影响 JSON 编码，反射互转时不生效，得自己解析 structTag 并判断逻辑
reflect.Value 的 Elem() 后的字段（比如传入的是 *MyStruct，得先 v.Elem() 再遍历）json:"user_name,omitempty"，双引号会编译报错map[string]interface{} 转结构体时 panic: reflect.Set: value of type map[string]interface{} is not assignable to type XXX
这是最常卡住的地方：想用 reflect.Value.Set() 直接把 map 值塞进 struct 字段，但类型不匹配。Go 反射不允许跨类型赋值，哪怕内容看起来能转。
- 必须逐字段处理：从 map 中取出
interface{}值，再按目标字段类型做显式转换（比如int64 ← float64、string ← []byte） - 时间字段特别容易翻车：
time.Time不能直接从string或int64赋值，得用time.Parse或time.Unix - 嵌套结构体要递归处理，别忘了检查
field.CanSet() && field.CanAddr()，否则Set()会 panic
性能差到不敢上生产？别直接用 reflect.Value.Interface() 回填 map
每次调用 Interface() 都触发一次内存分配和类型擦除，尤其在高频请求中，GC 压力明显。这不是“慢一点”，是量级差异。
- 对 map → struct，优先用代码生成（如
easyjson 或 msgp）替代运行时反射
- 如果必须用反射，缓存
reflect.Type 和字段索引（用 sync.Map 存 map[reflect.Type][]fieldInfo），避免每次重复 reflect.TypeOf().NumField()
- 字段名映射别每次都
strings.ToLower()，提前建好小写 key 到字段索引的 map
nil 指针、空 slice、零值字段在互转时怎么保留原意？
默认反射行为会把 nil slice 当成空 slice，把未设置的 struct 字段当成零值，但业务里“未提供”和“明确设为空”语义不同。
- map → struct 时，用
map 是否含 key 判断字段是否应被赋值，而不是依赖字段当前值
- struct → map 时，对指针字段，检查
!v.IsNil()；对 slice，检查 v.Len() == 0 && v.IsNil() 才算 truly empty
-
omitempty 标签只影响 JSON 编码，反射互转时不生效，得自己解析 structTag 并判断逻辑
easyjson 或 msgp）替代运行时反射reflect.Type 和字段索引（用 sync.Map 存 map[reflect.Type][]fieldInfo），避免每次重复 reflect.TypeOf().NumField()
strings.ToLower()，提前建好小写 key 到字段索引的 map- map → struct 时，用
map是否含 key 判断字段是否应被赋值，而不是依赖字段当前值 - struct → map 时，对指针字段，检查
!v.IsNil()；对 slice，检查v.Len() == 0 && v.IsNil()才算 truly empty -
omitempty标签只影响 JSON 编码，反射互转时不生效，得自己解析structTag并判断逻辑
字段标签解析、类型对齐、零值语义——这三块不抠细，转出来的数据看着像，跑着就错。
