必须传入结构体指针并调用Elem()才能获取可写Value；直接传值仅得只读Value，CanSet()为false；遍历前需检查v.Kind()==reflect.Struct以防panic。

怎么用 reflect.ValueOf 获取结构体字段值

直接传入结构体实例（非指针）会得到只读的 Value，无法修改字段；若要写入，必须传入指针并调用 Elem()。常见错误是忘记解引用，导致 CanSet() == false。

• 传入 &myStruct 而不是 myStruct
• 调用 reflect.ValueOf(ptr).Elem() 得到可写的结构体 Value
• 遍历前先检查 v.Kind() == reflect.Struct，避免 panic

type User struct {
    Name string
    Age  int
}
u := User{Name: "Alice", Age: 30}
v := reflect.ValueOf(&u).Elem() // 必须 Elem()
for i := 0; i < v.NumField(); i++ {
    field := v.Field(i)
    if field.CanInterface() {
        fmt.Printf("%s: %v\n", v.Type().Field(i).Name, field.Interface())
    }
}

如何安全地遍历带标签（tag）的导出字段

只有首字母大写的导出字段才能被 reflect 访问；小写字段会被跳过，且不会报错——这是最常被忽略的“静默失败”点。

• 用 v.Type().Field(i) 获取 StructField，它包含 Tag 和 Name
• 通过 field.Tag.Get("json") 提取特定 tag 值，注意返回空字符串表示未设置
• 字段名为空或 tag 解析失败时，不要假设默认行为，显式判断

type Config struct {
    Host string `json:"host" env:"HOST"`
    Port int    `json:"port"`
}
c := Config{Host: "localhost", Port: 8080}
v := reflect.ValueOf(c)
t := reflect.TypeOf(c)
for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    jsonTag := field.Tag.Get("json")
    if jsonTag == "-" { continue } // 显式忽略
    if jsonTag == "" { jsonTag = field.Name }
    val := v.Field(i).Interface()
    fmt.Printf("%s → %s = %v\n", field.Name, jsonTag, val)
}

为什么 reflect.Value.FieldByName 返回零值却不报错

字段名大小写敏感，且只匹配导出字段；传入小写字段名（如 "name"）会返回无效 Value，其 IsValid() == false，但不会 panic —— 容易误判为“字段不存在”而跳过处理。

• 始终用 field.IsValid() 检查结果有效性，而非只看 nil 或空
• 用 t.FieldByNameFunc 实现忽略大小写的查找（需自己实现逻辑，reflect 不内置）
• 若字段可能未导出，改用索引遍历 + 字符串比对，而不是依赖 FieldByName

v := reflect.ValueOf(u)
nameField := v.FieldByName("Name") // OK
nameField2 := v.FieldByName("name") // Invalid: !nameField2.IsValid()
if !nameField2.IsValid() {
    fmt.Println("no such exported field: name")
}

遍历嵌套结构体和指针字段时要注意什么

reflect 对指针、接口、切片等类型需要手动解包；直接调用 Field() 在非结构体上会 panic。典型场景是字段类型为 *OtherStruct 或 []string，必须先判断 Kind() 再分支处理。

立即学习“go语言免费学习笔记（深入）”；

• 对指针字段：先 Elem()，再检查是否为结构体
• 对接口字段：先 Elem()，再判断底层类型
• 对 slice/map：用 Len() 和 Index() 遍历，不能用 NumField()

type Order struct {
    User *User
    Tags []string
}
o := Order{User: &User{Name: "Bob"}}
v := reflect.ValueOf(o)
for i := 0; i < v.NumField(); i++ {
    f := v.Field(i)
    switch f.Kind() {
    case reflect.Ptr:
        if !f.IsNil() && f.Elem().Kind() == reflect.Struct {
            // 递归处理 *User
        }
    case reflect.Slice:
        for j := 0; j < f.Len(); j++ {
            fmt.Println("tag:", f.Index(j).Interface())
        }
    }
}