本文介绍如何利用 go 的 reflect 包在运行时动态获取结构体的公开字段名和关联方法名，并说明导出规则、指针类型差异及 go 风格实践建议。
本文介绍如何利用 go 的 reflect 包在运行时动态获取结构体的公开字段名和关联方法名，并说明导出规则、指针类型差异及 go 风格实践建议。
在 Go 中，结构体的字段和方法信息无法在编译期直接枚举，但可通过 reflect 包实现运行时动态检查。关键在于理解：字段属于结构体类型本身，而方法绑定在接收者类型上——若方法定义为 func (s *Student) ...，则方法实际归属于 *Student 类型，而非 Student 类型。
以下是一个完整示例，展示如何安全、准确地提取字段名与方法名：
package main
import (
"fmt"
"reflect"
)
type Student struct {
ID int // 导出字段（首字母大写）
Name string // 导出字段
Age int // 导出字段
}
// 所有方法均以大写字母开头，确保可被外部包调用（导出）
func (s *Student) SetID(i int) {
s.ID = i
}
func (s *Student) GetID() int {
return s.ID
}
func (s *Student) SetName(n string) {
s.Name = n
}
func (s *Student) GetName() string {
return s.Name
}
func (s *Student) SetAge(a int) {
s.Age = a
}
func (s *Student) GetAge() int {
return s.Age
}
func main() {
s := Student{ID: 1, Name: "Jack", Age: 22}
// 获取值类型的反射类型（对应 Student）
t := reflect.TypeOf(s)
// 获取指针类型的反射类型（对应 *Student）——方法在此注册
ptrT := reflect.TypeOf(&s)
// 提取导出字段名（仅首字母大写的字段可见）
var fields []string
for i := 0; i < t.NumField(); i++ {
field := t.Field(i)
if field.IsExported() { // 确保字段可访问
fields = append(fields, field.Name)
}
}
// 提取导出方法名
var methods []string
for i := 0; i < ptrT.NumMethod(); i++ {
method := ptrT.Method(i)
if method.IsExported() { // 方法同样需导出才可见
methods = append(methods, method.Name)
}
}
fmt.Println("Fields:", fields) // [ID Name Age]
fmt.Println("Methods:", methods) // [GetAge GetID GetName SetAge SetID SetName]
}⚠️ 重要注意事项：
- 导出规则决定可见性：只有首字母大写的字段和方法（如 ID、GetName）才能被 reflect 在包外访问；小写字段（如 id）即使存在，IsExported() 返回 false，reflect 无法读取其名称或值。
- 方法绑定于接收者类型：Student 类型无方法，*Student 才拥有全部方法。务必对指针取 reflect.TypeOf(&s)，而非 reflect.TypeOf(s)。
- Go 风格提示：Go 社区通常避免冗余的 getter/setter。若字段本身已导出（如 ID），可直接 s.ID = 100 或 v := s.Name；仅当需验证、封装逻辑或兼容接口时才定义方法。
总结：动态检视结构体元信息是调试、序列化、ORM 等场景的基础能力。掌握 reflect.TypeOf 的类型区分、IsExported() 安全过滤，以及 Go 的导出约定，是写出健壮反射代码的关键。
