Go反射不自动展开嵌入字段，FieldByName仅查直系字段；需手动遍历所有字段，对Anonymous为true者递归查找。
匿名字段在反射中为什么“看不见”
Go 的反射机制不会自动展开嵌入（anonymous）字段，reflect.Value.FieldByName 和 reflect.Type.FieldByName 默认只查**直接定义在当前结构体中的字段**，不递归搜索嵌入字段。即使你写了 type User struct { Person }，reflect.TypeOf(User{}).FieldByName("Name") 也会返回空，因为 Name 属于 Person，不是 User 的直系字段。
如何用反射访问嵌入字段的值
必须手动遍历结构体所有字段，对每个字段检查 Anonymous 标志，并递归进入其类型继续查找。这不是一次调用能解决的事。
- 先用
t := reflect.TypeOf(v)获取类型，遍历t.NumField() - 对每个
i，检查t.Field(i).Anonymous是否为true - 若为真，用
v.Field(i)取出值，再对其调用相同逻辑（注意：需确保该字段可寻址、非零值） - 遇到非结构体或非嵌入字段时停止递归
示例片段：
func findField(v reflect.Value, name string) (reflect.Value, bool) {
if v.Kind() == reflect.Ptr {
v = v.Elem()
}
if v.Kind() != reflect.Struct {
return reflect.Value{}, false
}
t := v.Type()
for i := 0; i < t.NumField(); i++ {
f := t.Field(i)
if f.Name == name {
return v.Field(i), true
}
if f.Anonymous {
val := v.Field(i)
if val.CanInterface() {
if res, ok := findField(val, name); ok {
return res, true
}
}
}
}
return reflect.Value{}, false
}
设置嵌入字段值时的常见 panic
最常遇到的是 reflect: reflect.Value.Set using unaddressable value —— 因为嵌入字段本身可能不可寻址（比如从 struct{A}{}. 直接取 reflect.Value 得到的是不可寻址副本）。
立即学习“go语言免费学习笔记（深入）”；
- 必须确保原始值是地址（
&v），否则FieldByName返回的子字段也必然不可寻址 - 嵌入字段如果是指针类型（如
*Person），要先判断是否为 nil，再Elem()；否则panic: call of reflect.Value.Interface on zero Value - 调用
Set()前务必检查CanSet()，尤其在嵌套多层后容易忽略
性能与可维护性提醒
反射访问嵌入字段本质是运行时线性搜索 + 递归，没有编译期字段解析快。每次调用都涉及类型检查、循环、接口转换，比直接点号访问慢 10–100 倍以上。
- 如果字段名固定、结构已知，优先用类型断言或显式字段路径（
v.Person.Name）代替反射 - 避免在 hot path（如 HTTP handler 内部）反复做嵌入字段反射查找
- 某些 ORM 或序列化库（如
gorm、mapstructure）内部已封装这类逻辑，直接复用比手写更稳
真正需要手动处理嵌入字段反射的场景其实不多——多数时候是你在写泛型工具、调试辅助函数，或者对接不规范的外部数据结构。这时候记得：递归入口要 guard 类型，赋值前必 check CanAddr() 和 CanSet()，别信“它应该能工作”。
