Go types.NewMethodSet 怎样列出嵌入类型提升的方法

做 Go 静态分析时，直接看结构体声明只能看到一部分方法；嵌入字段带来的提升方法也属于调用者可见的方法集合。要完整列出它们，先用 go/types 完成类型检查，再把目标类型传给 types.NewMethodSet，通过 Len 和 At 遍历每个 *types.Selection。读取 Selection.Obj() 得到方法对象，读取 Index() 就能保留它从外层类型到嵌入类型的索引路径。

官方参考地址：https://pkg.go.dev/go/types#NewMethodSet

先准备一个包含提升方法的类型

下面的示例让 Wrapper 嵌入 Base。Read 使用值接收者，Write 使用指针接收者，Own 是外层类型自己的方法。为了让 go/types 看到完整信息，输入必须先经过 parser 和 checker。

package main

import (
    "go/ast"
    "go/parser"
    "go/token"
    "go/types"
)

const source = `package demo

type Base struct{}
func (Base) Read() {}
func (*Base) Write() {}

type Wrapper struct { Base }
func (Wrapper) Own() {}
`

func checkedFile() (*types.Package, *token.FileSet, error) {
    // 先解析源码，保留位置集合，后续诊断和索引路径都依赖它。
    fset := token.NewFileSet()
    file, err := parser.ParseFile(fset, "demo.go", source, 0)
    if err != nil {
        return nil, nil, err
    }
    // 类型检查完成后，包作用域中的 Wrapper 才能提供可遍历的 Type。
    pkg, err := new(types.Config).Check("demo", fset, []*ast.File{file}, nil)
    return pkg, fset, err
}

这里没有手工拼接方法列表。嵌入规则、接收者类型和方法签名交给类型检查器处理，后面只消费它公开的类型信息。

用 NewMethodSet 遍历方法选择

从包作用域取出 Wrapper 后，分别传入它本身和指针类型。MethodSet.At 返回的是选择结果，而不是简单的 *types.Func；这样才能同时保留“方法被谁选中”和“方法在哪里声明”的信息。

package main

import (
    "fmt"
    "go/types"
)

func printMethods(pkg *types.Package) {
    // 从包作用域拿到命名类型，避免用字符串猜测底层结构。
    wrapper := pkg.Scope().Lookup("Wrapper").Type()
    targets := []struct {
        name string
        typ  types.Type
    }{
        {"Wrapper", wrapper},
        {"*Wrapper", types.NewPointer(wrapper)},
    }

    for _, target := range targets {
        // NewMethodSet 即使没有方法也返回非 nil 集合。
        set := types.NewMethodSet(target.typ)
        fmt.Println(target.name, "methods:", set.Len())
        for i := 0; i 

示例输出中的方法数量和顺序由类型集合决定，重点不是把它当成字符串，而是把每项当成结构化对象。Obj().Name() 适合展示名称，Obj().Type() 适合展示签名，Index() 则适合写入分析结果。

Index 和 Recv 怎样识别提升层级

对外层自有方法，Index() 通常只有一个位置；对通过嵌入字段提升的方法，索引切片会包含通往嵌入字段的路径。不要仅凭 Indirect() 判断“是不是提升方法”，它描述的是选择过程中是否发生指针间接，和嵌入层级不是同一个概念。

如果工具要生成文档或补全提示，建议把方法名、签名和索引路径一起保存。多个嵌入分支出现同名方法时，Go 的选择规则可能让某个方法不可见；这时不能把所有声明方法简单拼接成列表，否则输出会和语言实际可调用集合不一致。

值类型和指针类型要分别处理

语言规范规定，结构体嵌入值类型 T 时，T 和 *T 都能得到值接收者方法；只有指针类型的方法会在指针集合中出现。嵌入 *T 时，值和指针集合的提升范围又不同。因此，代码分析器如果只调用一次 NewMethodSet(wrapper)，很容易漏掉 Write 这一类方法。

• 需要模拟值表达式调用时遍历 T。
• 需要模拟可寻址变量、指针接收者或接口实现时，同时遍历 *T。
• 需要判断方法是否来自嵌入字段时保存 Index()，不要只保存名称。

常见问题

NewMethodSet 返回空集合时需要判空吗？

不需要判空。官方文档说明它始终返回非空的 *types.MethodSet；直接读取 Len() 即可。

为什么 MethodSet 的结果和 Named.Methods 不一样？

Named.Methods 面向命名类型直接声明的方法，而 NewMethodSet 面向某个具体类型的可用方法集合，可能包含嵌入提升、指针边界和接口方法。

只想查一个方法还要遍历全部集合吗？

可以调用 MethodSet.Lookup 按包和名称查询；但如果要导出完整索引、处理提升路径或比较 T 与 *T，仍应遍历并保存 Selection 的上下文。