NumMethod() 返回类型导出方法数,含嵌入类型方法;Methods() 返回完整方法信息,含名称、签名等细节,索引从0到NumMethod()-1。

Go 语言的 reflect 包允许你在运行时检查任意类型的结构、字段和方法。要动态获取一个类型(尤其是接口或具体结构体)上定义的方法数量,关键在于使用 reflect.Type.Methods() 或 reflect.Type.NumMethod() —— 后者更轻量、更高效。
用 NumMethod() 快速获取方法总数
这是最直接的方式:它返回该类型导出(public)方法的数量,不涉及反射调用,性能好,适合做静态检查。
- 只统计导出方法:非首字母大写的私有方法不会被计入
- 包含嵌入类型的方法:如果结构体嵌入了其他类型,其导出方法也会被合并计入(前提是未被重写)
-
对接口类型同样适用:比如
*os.File实现的io.Reader接口,可查接口本身声明的方法数
示例:
func countMethods(v interface{}) int {return reflect.TypeOf(v).NumMethod()
}
用 Methods() 获取完整方法信息
当你不仅要知道数量,还想了解每个方法的名称、签名、是否导出、是否是接收指针等细节时,用 Method(i) 遍历。
立即学习“go语言免费学习笔记(深入)”;
- 返回
reflect.Method结构,含Name、Type(函数类型)、PkgPath(为空表示导出)、Func(可调用的反射函数值) - 注意:
Method(i)的索引从 0 开始,最多到NumMethod()-1 - 对指针类型和值类型调用
reflect.TypeOf可能结果不同:例如reflect.TypeOf(T{})和reflect.TypeOf(&T{})的方法集可能不一致(尤其当某些方法只定义在指针接收器上时)
示例(打印所有方法名):
t := reflect.TypeOf((*strings.Builder)(nil)).Elem() // 获取 Builder 值类型for i := 0; i m := t.Method(i)
fmt.Println(m.Name, m.Type)
}
区分值类型与指针类型的方法集
Go 中方法集规则会影响 reflect 的结果:
-
T类型的方法集 = 所有值接收器方法 -
*T类型的方法集 = 所有值接收器 + 所有指针接收器方法 - 因此
reflect.TypeOf(T{}).NumMethod()≤reflect.TypeOf(&T{}).NumMethod() - 若想模拟接口断言行为(如
var _ io.Writer = &T{}),应使用指针类型做反射分析
检查接口类型的方法数量
对任意接口类型(包括自定义接口),可直接用 reflect.TypeOf((*YourInterface)(nil)).Elem().NumMethod() 获取其声明的方法数。
- 注意不能对 nil 接口变量直接
reflect.TypeOf(nil)(会 panic),必须用带类型标注的 nil 指针 - 例如:获取
error接口的方法数:reflect.TypeOf((*error)(nil)).Elem().NumMethod()→ 返回 1(即Error() string) - 这在泛型约束校验、代码生成或 DSL 元编程中很实用










