直接调用 reflect.value.numfield() 会 panic，因为未检查 val.isvalid() 就访问字段；需先验证有效性、处理指针解引用、跳过未导出字段，并对匿名字段和循环引用做特殊防护。
为什么直接用 reflect.Value.NumField() 会 panic
因为嵌套结构体里常混着指针、interface{}、nil 值，甚至循环引用。比如 val.Field(i) 遇到 nil 指针字段，不加判断就调用，立刻崩溃；val.Interface() 对未导出字段（小写开头）也 panic。这不是“写错了”，而是反射 API 的硬性约束：它不替你兜底。
- 每次取字段前必须先检查
val.IsValid()，否则val.Kind()或val.NumField()都可能触发 panic - 只对
val.CanInterface() == true的字段做类型转换，跳过所有小写字段 - 遇到指针类型，得先
val.Elem()解引用，再判断是否为reflect.Struct，不能直接对*Address调NumField() - interface{} 类型要先
val.Elem()再判断底层值，否则val.Kind()返回的是Interface，不是它包裹的真实类型
如何安全递归遍历嵌套结构体并保留字段路径
核心是把“路径拼接”和“类型分发”拆开：每层递归传入当前路径字符串，遇到基础类型（string/int/bool 等）就回调记录；遇到 struct 就继续下钻；遇到 map/slice 就按需展开（通常不进 map 的 value，除非明确需要）。路径统一用 . 连接，比如 User.Profile.Address.City，方便后续映射 JSON key 或配置项。
- 入口函数先处理指针：若
reflect.ValueOf(v).Kind() == reflect.Ptr，则val = val.Elem() - 递归函数
walkValue(val, path, fn)开头必须有if !val.IsValid() { return } - struct 场景下，遍历
val.NumField()前，用t := val.Type()获取字段名，拼接新路径：newPath := path + "." + t.Field(i).Name - 对非 struct 类型（如 int、string、time.Time），直接调用
fn(newPath, val.Interface())，不继续递归 - map 和 slice 默认不递归——除非业务明确要展开，否则容易陷入无限循环或性能爆炸
嵌套结构体中匿名字段怎么影响反射路径
匿名字段（如 type User struct { Profile } ）在反射里仍是独立字段，但它的字段会被提升到外层作用域。反射本身并不“知道”这是匿名嵌入，它只看到 User 的字段列表里有个类型为 Profile 的字段，名字就是 Profile（Go 编译器生成的匿名字段名）。所以路径仍是 User.Profile.Name，不是 User.Name —— 反射层面没有自动扁平化。
- 想获得“扁平化路径”（即跳过中间层），得在递归时识别匿名字段：
t.Field(i).Anonymous == true，然后把其内部字段名拼到当前路径后，而不是用字段名本身 - 但要注意：匿名字段本身仍可能是指针或 interface{}，同样要先
Elem()再判断有效性，不能假设它一定可访问 - 如果匿名字段类型是未导出结构体（如
profile小写），即使嵌入了，反射也读不到它的字段 ——CanInterface()为 false，必须跳过 - JSON tag（如
json:"user_name"）不影响反射路径生成，它只在序列化时起作用；反射看到的永远是 Go 字段名
容易被忽略的循环引用和性能陷阱
结构体字段互相引用（比如 A 包含 B，B 又包含 *A）时，纯递归会无限深入。这不是 bug，是数据本身的问题。反射无法自动检测循环，必须手动维护已访问地址集合。另外，频繁调用 val.Interface() 会触发内存分配，尤其在深嵌套+大结构体场景下，GC 压力明显。
- 用
map[uintptr]bool记录每个val.UnsafeAddr()，进入 struct 前查表，命中则 return - 避免在递归中反复调用
val.Type()或t.Field(i)—— 它们开销不小，可提前缓存t和字段信息 - 基础类型值（int/string）直接传
val.Interface()没问题，但大 struct 或 slice 建议传val本身，由回调函数决定是否 .Interface() - 如果只是校验字段合法性或提取 tag，根本不用 .Interface()，用
val.Kind()和t.Field(i).Tag.Get("json")就够了
if !val.IsValid() —— 它像安全带，不系上，一撞就飞。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
