17370845950

必须用 reflect.TypeOf 获取字段名、类型、标签，用 reflect.ValueOf(&s).Elem() 获取可寻址值以读写字段；私有字段无法通过反射访问；StructTag 解析需注意空值与拼写；高频场景应缓存 Type 避免重复反射。

如何用 reflect.TypeOf 和 reflect.ValueOf 获取结构体字段基本信息

必须先区分类型信息和值信息：获取字段名、类型、标签要用 reflect.TypeOf；读写字段值则必须用 reflect.ValueOf，且该值需为可寻址（&struct{}）才能修改。

• reflect.TypeOf(v).Kind() 返回 reflect.Struct 才能继续调用 NumField()
• 直接对结构体字面量调用 reflect.ValueOf(s) 得到的是不可寻址的副本，CanSet() 为 false
• 若要修改字段，必须传入指针：reflect.ValueOf(&s)，再用 .Elem() 取到结构体值

type User struct {
	Name string `json:"name" validate:"required"`
	Age  int    `json:"age"`
}

u := User{Name: "Alice", Age: 30}
t := reflect.TypeOf(u)        // 获取 Type
v := reflect.ValueOf(&u).Elem() // 获取可修改的 Value

for i := 0; i < t.NumField(); i++ {
	f := t.Field(i)
	fmt.Printf("字段名: %s, 类型: %s, JSON标签: %s\n", 
		f.Name, f.Type, f.Tag.Get("json"))
}

为什么 FieldByName 找不到私有字段？

Go 的反射严格遵循导出规则：只有首字母大写的字段才是导出字段，FieldByName 和 FieldByNameFunc 均无法访问小写开头的字段，无论是否通过指针传入。

• 即使传入 &struct{ name string }，v.FieldByName("name") 返回零值，IsValid() 为 false
• 没有绕过该限制的合法方式；强行用 unsafe 操作内存属于未定义行为，生产环境禁用
• 若需运行时动态访问非导出字段，应重构设计——例如提供公开的 GetXXX() 方法或使用接口抽象

StructTag 解析常见错误：空字符串、拼写错误与嵌套标签

f.Tag.Get("json") 返回空字符串不等于标签不存在，可能只是该 key 对应值为空（如 json:""），也可能是 key 拼写错误（如写成 "JSON"）。

• 标签字符串必须是反引号包裹的纯字符串，不能换行或含注释
• 多个键值对之间用空格分隔，但

  

  每个键值对内部不能有空格：`json:"name,omitempty" db:"name"` ✅，

  `json:"name, omitempty"` ❌

• 使用 reflect.StructTag 可安全解析：tag := f.Tag; jsonTag := tag.Get("json")，无需手动切分