本文介绍如何使用 Go 的 reflect 包在运行时动态获取结构体的公开字段名和方法名，并说明导出规则、指针类型差异及 Go 风格实践建议。
本文介绍如何使用 go 的 `reflect` 包在运行时动态获取结构体的公开字段名和方法名，并说明导出规则、指针类型差异及 go 风格实践建议。
在 Go 语言中，结构体的字段与方法信息无法通过常规语法直接枚举，必须借助 reflect 包进行运行时反射操作。需要注意的是：字段和方法是否可被反射访问，取决于其导出状态（即首字母是否大写）；且方法绑定在特定接收者类型上——值类型与指针类型拥有不同的方法集。
以下是一个完整示例，演示如何动态列出 Student 结构体的字段与方法：
package main
import (
"fmt"
"reflect"
)
type Student struct {
ID int // 导出字段（首字母大写），可被反射访问
Name string // 同上
Age int // 同上
}
// 所有方法均以大写字母开头，确保导出并可被外部包及 reflect 访问
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}
// 获取值类型的反射类型（用于字段）
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]
}? 关键注意事项：
- 导出规则决定可见性：reflect 只能访问首字母大写的导出字段/方法。原始问题中 id、name、age 等小写字段在反射中虽存在，但 Field(i).Name 返回空字符串（不可见），且 IsExported() 返回 false。因此务必使用 ID、Name、Age 等导出命名。
- 方法集归属明确：Student 类型本身无方法（因方法定义在 *Student 上），故需用 &s 的类型（即 *Student）获取方法列表。若方法接收者为 Student（值类型），则应使用 reflect.TypeOf(s) 获取方法。
- Go 风格提醒：Go 社区普遍不鼓励机械式 GetXXX/SetXXX 模式。更惯用的做法是直接暴露字段（如 s.Name = "Jack"），并通过文档或接口约束行为；仅在需要验证、封装逻辑或实现接口时才定义方法。
掌握 reflect.TypeOf、NumField/Field、NumMethod/Method 等 API，配合导出规则理解，即可稳健实现结构体元信息的动态探查，适用于序列化、ORM 映射、调试工具等场景。
