Golang结构体方法遍历技巧详解

目前golang学习网上已经有很多关于Golang的文章了，自己在初次阅读这些文章中，也见识到了很多学习思路；那么本文《Golang结构体方法遍历技巧分享》，也希望能帮助到大家，如果阅读完后真的对你学习Golang有帮助，欢迎动动手指，评论留言并分享~

Go中反射获取结构体方法需同时检查值类型和指针类型，且仅导出方法可见；接收者为T的方法在TypeOf(t)中，*T的在TypeOf(&t)中。

Go 语言中无法像 Python 那样直接用 dir() 查看结构体所有方法，必须借助 reflect 包；但要注意：只有**导出（首字母大写）的方法**才能被 reflect.Methods 获取到。

为什么 reflect.TypeOf(t).Method(i) 总是返回空？

常见原因是传入了值而非指针，或方法未导出：

• reflect.TypeOf(t) 获取的是值类型，其 Method 列表只包含该类型定义的方法（不包含接收者为 *T 的方法）
• 若结构体方法接收者是 *T，必须用 reflect.TypeOf(&t) 获取指针类型，否则 NumMethod() 返回 0
• 小写字母开头的方法（如 setName）在反射中完全不可见，无论接收者是 T 还是 *T

正确遍历结构体所有导出方法的完整步骤

以结构体 User 为例，需同时检查值类型和指针类型，覆盖接收者为 T 和 *T 的导出方法：

package main
import (
"fmt"
"reflect"
)
type User struct {
Name string
}
func (u User) GetName() string { return u.Name }        // 值接收者
func (u *User) SetName(name string) { u.Name = name }    // 指针接收者
func main() {
u := User{Name: "Alice"}
// 获取值类型的反射对象
t := reflect.TypeOf(u)
fmt.Printf("Value type methods (%d):\n", t.NumMethod())
for i := 0; i < t.NumMethod(); i++ {
    m := t.Method(i)
    fmt.Printf("- %s (recv: %s)\n", m.Name, m.Type.In(0))
}

// 获取指针类型的反射对象
pt := reflect.TypeOf(&u)
fmt.Printf("\nPtr type methods (%d):\n", pt.NumMethod())
for i := 0; i < pt.NumMethod(); i++ {
    m := pt.Method(i)
    fmt.Printf("- %s (recv: %s)\n", m.Name, m.Type.In(0))
}
}

输出会显示 GetName 在值类型中、SetName 在指针类型中 —— 这正是 Go 方法集规则的体现。

Method 和 MethodByName 的关键区别与陷阱

Method(i) 是按声明顺序索引，而 MethodByName(name) 只搜索当前类型的方法集（不跨值/指针类型自动切换）：

• reflect.ValueOf(u).MethodByName("SetName") 会返回零值，因为 u 是值，SetName 不在其方法集中
• reflect.ValueOf(&u).MethodByName("GetName") 却能成功，因为 Go 允许从 *T 调用 T 的方法（自动解引用）
• 但反过来不行：reflect.ValueOf(u).MethodByName("SetName") 永远失败

所以实际调用前，务必确认接收者类型匹配，或统一使用指针反射对象（reflect.ValueOf(&x)）来获得最全方法集。

真正麻烦的不是怎么遍历，而是得时刻记住：Go 的方法集是静态的、按接收者类型严格划分的，反射只是把它照实暴露出来 —— 没有“自动补全”或“跨类型查找”。漏掉指针类型或误判导出规则，就什么也看不到。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang结构体方法遍历技巧详解》文章吧，也可关注golang学习网公众号了解相关技术文章。