用 reflect.Value 递归遍历 + 路径拼接 + 类型安全校验是处理嵌套结构体最可靠的方式；需手动跳过未导出字段、解引用指针、防循环引用，且每次操作前必须检查 val.IsValid() 和 val.CanInterface()，路径用 . 分隔。
直接说结论：用 reflect.Value 递归遍历 + 路径拼接 + 类型安全校验，是处理嵌套结构体最可靠的方式；但必须手动跳过未导出字段、解引用指针、防循环引用，否则一跑就 panic。
怎么递归获取所有可导出的嵌套字段（含路径和值）
核心是写一个深度优先的遍历函数，每进入一层结构体，就把当前字段名追加到路径里，遇到基础类型就停止并记录。关键不是“能不能进”，而是“敢不敢进”——得先检查有效性。
-
val.IsValid()必须在每次取值前调用，否则val.Field(i)遇到 nil 指针或空 interface 就直接 panic - 只处理
val.CanInterface()为 true 的字段，避免对未导出字段（小写开头）做.Interface()操作 - 对指针字段，先
val.Elem()再判断.Kind() == reflect.Struct，不能直接对*Address调NumField() - 路径分隔符统一用
.，比如User.Address.City，方便后续映射 JSON key 或配置项
func WalkStruct(v interface{}, fn func(path string, value interface{})) {
val := reflect.ValueOf(v)
if val.Kind() == reflect.Ptr {
val = val.Elem()
}
if !val.IsValid() || val.Kind() != reflect.Struct {
return
}
walkValue(val, "", fn)
}
func walkValue(val reflect.Value, path string, fn func(string, interface{})) {
if !val.IsValid() {
return
}
if val.Kind() == reflect.Struct {
t := val.Type()
for i := 0; i < val.NumField(); i++ {
field := val.Field(i)
fieldType := t.Field(i)
newPath := path
if newPath != "" {
newPath += "."
}
newPath += fieldType.Name
if field.Kind() == reflect.Struct {
walkValue(field, newPath, fn)
} else if field.CanInterface() {
fn(newPath, field.Interface())
}
}
}
}
为什么 FieldByName 找不到嵌套字段？常见卡点在哪
不是语法错，是反射的“可见性规则”和“类型层级”没理清。比如 user.Addr.City，你不能对 user 直接调 FieldByName("Addr.City") —— FieldByName 只查一级，不支持点号路径。
-
FieldByName("Addr")返回的是Address结构体值，它的Kind()是struct，但你还得再调一次.FieldByName("City") - 如果
Addr是*Address且为nil，.Elem()会 panic，必须先if !field.IsNil() { field = field.Elem() } - 匿名字段（如
Address不带名字）会让City“升维”到User层，这时user.FieldByName("City")是合法的 —— 但前提是City本身已导出 - 传参时若传结构体值而非指针，
FieldByName能读不能写；要修改必须从reflect.ValueOf(&user)开始
如何安全地通过字符串路径设置嵌套字段（比如 "Profile.Address.Zip"）
本质是把路径切片后逐层 FieldByName，但每一步都得做三件事：检查是否存在、是否可寻址、是否需要初始化 nil 指针。
立即学习“go语言免费学习笔记（深入）”；
- 路径解析用
strings.Split(path, ".")，别手写状态机 - 每一层都要确认
current.Kind() == reflect.Ptr && current.IsNil()，是的话用reflect.New(t.Elem())创建实例再Set() - 最终字段必须满足
field.CanSet()，否则SetXXX()会 panic —— 这意味着原始变量必须是指针传入，且字段已导出 - 值类型不匹配时（比如想塞
string到int字段），要用Convert()或提前校验，Go 反射不会自动类型转换
嵌套越深，越容易在第三层或第四层突然遇到 nil 指针或未导出字段而中断；真正难的不是写递归，而是想清楚哪一层该 panic 哪一层该跳过——这得结合业务语义来定，反射本身只负责“能访问”，不负责“该不该访问”。
