Go反射无法访问首字母小写的未导出字段，FieldByName对私有字段返回无效值；调用MethodByName需值可寻址且方法导出；匿名字段仅在导出时参与字段提升；Interface()前须检查IsValid()和CanInterface()。
为什么 reflect.Value.FieldByName 读不到以小写字母开头的字段
Go 的反射无法访问未导出（即首字母小写）字段，这是语言层面的限制，不是 reflect 的 bug。即使结构体字段上有 tag、类型明确、值非 nil，reflect.Value.FieldByName("name") 对小写字段也直接返回零值且 IsValid() 为 false。
常见错误现象：
type User struct {
name string // 小写 → 不可反射读取
Age int
}
u := User{name: "alice", Age: 30}
v := reflect.ValueOf(u)
fmt.Println(v.FieldByName("name").IsValid()) // false
fmt.Println(v.FieldByName("Age").IsValid()) // true
- 只有首字母大写的字段才被导出，才能被
reflect读写 - struct tag（如
json:"name"）不影响字段是否可反射访问 - 若必须操作私有字段，只能通过指针 +
reflect.Value.Elem()+FieldByName组合，但依然受限于导出性 —— 私有字段仍不可达
如何安全地用 reflect.Value.MethodByName 调用结构体方法
调用方法前必须确保：值是可寻址的（addressable），且方法是导出的（首字母大写）。传入非指针值或调用私有方法都会 panic。
典型错误：
type User struct{ Name string }
func (u User) GetName() string { return u.Name }
func (u *User) SetName(n string) { u.Name = n }
u := User{Name: "bob"}
v := reflect.ValueOf(u)
m := v.MethodByName("SetName") // panic: call of reflect.Value.Call on zero Value
- 使用
reflect.ValueOf(&u).Elem()获取可寻址的 struct 值，才能调用指针接收者方法 - 值接收者方法（如
GetName）可用reflect.ValueOf(u)直接调用，但前提是该方法已导出 - 检查方法是否存在：先用
v.MethodByName("XXX")，再判断返回值.IsValid()，避免 panic - 参数需包装为
[]reflect.Value，每个元素必须与方法签名严格匹配（类型、数量）
reflect.StructField 的 Anonymous 字段有什么实际影响
嵌入字段（anonymous field）的 Anonymous 标志决定它是否参与“字段提升”——即是否能被 FieldByName 直接查到。但仅当该嵌入字段本身是导出的，其字段才可能被提升。
示例：
type Person struct {
Name string
}
type Employee struct {
Person // 导出的匿名字段 → Name 可被 FieldByName("Name") 找到
ID int
}
e := Employee{Person: Person{Name: "carol"}, ID: 101}
v := reflect.ValueOf(e)
fmt.Println(v.FieldByName("Name").String()) // "carol"
- 如果嵌入的是
person Person（非匿名），则必须v.FieldByName("person").FieldByName("Name") - 如果嵌入的是
person unexportedStruct（小写类型且未导出），即使Anonymous==true，其字段也不会被提升 -
reflect.Type.FieldByName和reflect.Value.FieldByName都遵循同一套提升规则
用 reflect.Value.Interface() 取值时最常见的 panic 场景
Interface() 要求值是“可表示的”（representable）：不能是未导出字段、不能是未寻址的不可寻址值（如 struct 字面量直接反射）、也不能是空接口底层为 nil 的情况。
立即学习“go语言免费学习笔记（深入）”；
最常踩的坑：
type Config struct{ port int }
c := Config{port: 8080}
v := reflect.ValueOf(c).FieldByName("port") // 不可导出 → v 无效
x := v.Interface() // panic: reflect: call of reflect.Value.Interface on zero Value
- 务必在调用
Interface()前检查v.IsValid() && v.CanInterface() -
CanInterface()返回 false 的典型场景：字段未导出、值来自非指针的 struct 字面量、或由reflect.Zero()构造 - 如果只是想转成基础类型，优先用
v.Int()、v.String()等专用方法（它们对无效值返回 0/""，不 panic）
