反射遍历 struct 时 FieldByName 对未导出字段返回零值而非报错，应确保字段首字母大写、用 NumField/Field 遍历并检查 PkgPath；取值前须调 IsValid()，指针字段需 IsNil() 判断；嵌套结构要递归但避开 time.Time 等特殊类型；数值和时间建议显式转换；反射性能差，高频场景应手写或代码生成。
反射遍历 struct 字段时，FieldByName 返回 nil 是最常见的误判点
Go 的反射对未导出字段（小写开头）完全不可见，FieldByName 查不到就直接返回零值，不是报错也不是 panic。很多人以为结构体字段“存在但没值”，其实是根本没访问权限。
- 确保所有要转成 map 的字段名首字母大写（即导出）
- 用
Value.NumField()+Value.Field(i)遍历，比反复调FieldByName更可靠 - 检查
StructField.PkgPath是否为空字符串——非空说明字段未导出，反射拿不到
嵌套 struct 和指针字段容易导致 panic: reflect: call of reflect.Value.Interface on zero Value
当 struct 字段是 *T 类型且值为 nil，或字段本身是未初始化的 struct，Interface() 会 panic。这不是 bug，是反射的明确行为约束。
- 每次取字段前先用
IsValid()判断是否有效值 - 对指针字段，加一层
IsNil()检查再决定是否解引用：if !v.IsNil() { v = v.Elem() } - 嵌套 struct 要递归处理，但别无脑递归——遇到
time.Time、json.RawMessage这类类型应直接转字符串或跳过
map[string]interface{} 中时间、数字、布尔等基础类型表现不一致
反射拿到的 time.Time 字段，Interface() 返回的是原值，但 JSON 编码时会走 MarshalJSON；而直接塞进 map 后再序列化，就可能丢失格式控制。数字类型在 int/int64/float64 间也容易混淆。
- 对
time.Time，建议统一转成Format后的字符串，避免下游解析歧义 - 对数值字段，用
Kind()判断原始类型：比如v.Kind() == reflect.Int64就别强转成 float64 - 布尔字段没问题，但注意 struct tag 里写了
json:",omitempty"的字段，在反射里不会自动跳过——得自己解析 tag
性能敏感场景下，反射转换比 hand-written map 构造慢 5–10 倍
反射要构建 Type 和 Value 对象、遍历字段、做类型检查，开销固定且不小。实测百万次转换，反射版耗时约 800ms，手写版约 120ms。
立即学习“go语言免费学习笔记（深入）”；
- 如果结构体固定、字段不多，直接写
map[string]interface{}{"Name": s.Name, "Age": s.Age}更快更稳 - 想兼顾通用和性能，可用
go:generate+ 模板生成转换函数，运行时零反射 - 别在 HTTP handler 热路径里反复反射 struct → map，尤其带嵌套时，GC 压力会上升
真正麻烦的不是怎么写反射逻辑，而是字段类型混杂、tag 控制多、还要兼容历史数据——这时候与其硬调 reflect.Value，不如先收拢 struct 定义，把可选字段、时间格式、空值语义定清楚。
