Go types.Interface 怎样分别列出显式方法和完整方法集

列出 Go 接口直接声明的方法，用 NumExplicitMethods 配合 ExplicitMethod；列出包含嵌入接口方法的完整方法集，用 NumMethods 配合 Method。两组接口回答的问题不同，不能只因方法数量不一致就判断类型检查丢了方法。

官方文档：https://pkg.go.dev/go/types#Interface

明确两组方法查询的用途

接口文档生成器常需要同时显示“本接口新增哪些方法”和“使用者最终需要实现哪些方法”。前一个视图保留声明层次，后一个视图展平嵌入关系。本篇使用现有标准库能力，不把它包装为新发布功能。

解析一个带嵌入接口的最小样例

例子定义 Reader，再由 Store 嵌入它并声明 Close。程序先完成类型检查，再获取 Store 的底层接口类型，随后分别枚举两组列表。源码不导入其他包，因此检查配置不需要导入器。

package main

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

func main() {
    // Reader 提供嵌入方法，Store 另有一个直接声明的方法。
    const source = `package sample
type Reader interface {
    Read([]byte) (int, error)
}
type Store interface {
    Reader
    Close() error
}`
    fset := token.NewFileSet()
    file, err := parser.ParseFile(fset, "sample.go", source, 0)
    if err != nil {
        panic(err)
    }
    conf := types.Config{}
    pkg, err := conf.Check("sample", fset, []*ast.File{file}, nil)
    if err != nil {
        panic(err)
    }

    // 包作用域拿到的是类型名，Underlying 才是接口表示。
    obj := pkg.Scope().Lookup("Store")
    if obj == nil {
        panic("没有找到 Store")
    }
    iface, ok := obj.Type().Underlying().(*types.Interface)
    if !ok {
        panic("Store 的底层类型不是接口")
    }
    iface.Complete()

    // 每个取值函数都使用自己对应的数量上界。
    fmt.Println("显式方法：")
    for i := 0; i 

按照这个声明，显式列表只有 Close，完整列表包含 Close 和 Read。这是由源码关系得出的预期，不是本地执行日志。两个列表中的方法按唯一 Id 排序，不承诺遵循源码书写顺序。

把枚举结果接到文档或分析器里

生成接口概览时，可以用显式列表展示本层职责，再用完整列表生成实现清单。若还要展示嵌入来源，则单独遍历 EmbeddedType；不要为了获得完整方法列表，手工递归嵌入接口后直接拼接名称。

手工拼接容易重复收集同一方法，也容易忽略未导出方法的包身份。需要稳定标识时，可使用方法对象的 Id；只展示 Name 适合简单阅读列表，不能把裸方法名当成所有场景下的唯一键。接口是否合法以及重叠方法如何处理，应交给类型检查器。

如果做的是源码导航或自动修改，还应保存 AST 节点与位置。语义列表用于回答“有哪些方法”，而不是完整复原“源文件如何排版、哪一行写了嵌入项”。

避免把方法列表当成全部约束

现代 Go 接口也可以描述类型集合限制。某个约束接口没有方法，不意味着它可以代表任意类型。单看 NumMethods 的数量，无法完整理解类型项、联合项或其他限制。

这也是两组枚举 API 与通用类型分析的分界：方法清单适合展示契约中的行为部分，不能代替完整的约束分析。需要判断接口是否完全由方法集描述时，可以进一步查看 IsMethodSet，而不是用“方法数为零”代替判断。

处理构造、顺序和错误输入

对类型检查器已经返回的有效接口，通常已经完成所需的类型集合计算。若通过 NewInterfaceType 手工构造接口，必须等嵌入类型定义完整后调用 Complete，再进行通常的接口使用；在此之前不要把对象交给并发读取方。

为什么直接断言 types.Interface 失败？定义类型往往以 Named 表示，应先查看 Underlying 并保留失败分支。想保持源码顺序怎么办？使用 AST 的字段顺序组织展示，再关联类型对象，不依赖方法枚举顺序。两个循环能共用 NumMethods 上界吗？不能，ExplicitMethod 的合法索引范围由 NumExplicitMethods 决定。

在工具里同时保留“显式声明”和“完整契约”两个视图，通常能把嵌入带来的差异解释清楚，也便于读者区分接口自身职责与继承而来的要求。