Go types.NewInterfaceType 怎样构造带嵌入接口的方法集

用 go/types 做静态分析、代码生成或自定义类型检查时，常见任务不是解析一段接口源码，而是根据已经拿到的 *types.Func 和接口类型，手工拼出一个 *types.Interface。这时可以用 types.NewInterfaceType 同时传入显式方法和嵌入类型，再调用 Complete() 计算完整的方法集。

最小可靠流程是：先准备方法与嵌入接口，再调用 NewInterfaceType，等所有嵌入类型都定义完成后调用 Complete()，最后再读取 NumMethods、Method 等结果。

先分清两类输入

NewInterfaceType(methods, embeddeds) 的第一个参数是显式声明的方法列表，类型为 []*types.Func；第二个参数是嵌入的类型列表，类型为 []types.Type。后者比旧的 NewInterface 更宽，可以表达不只由命名类型承载的接口类型。

这两个列表描述的是接口的“来源”，不是最终方法集。显式方法只来自 methods，嵌入接口贡献的方法要等 Complete() 计算后，才会出现在 NumMethods() 和 Method(i) 的结果里。

准备 go/types 方法对象

手工构造方法时，先用 types.NewSignatureType 描述参数和返回值，再把签名交给 types.NewFunc。下面的示例构造一个带 Read 方法的接口，同时准备一个可嵌入的 Writer 接口。

package main

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

func main() {
    pkg := types.NewPackage("example.com/demo", "demo")
    stringType := types.Typ[types.String]
    errorType := types.Universe.Lookup("error").Type()

    // 先构造 Writer 接口的显式方法。
    writeSig := types.NewSignatureType(
        nil, nil, nil,
        types.NewTuple(types.NewVar(token.NoPos, pkg, "p", stringType)),
        types.NewTuple(types.NewVar(token.NoPos, pkg, "err", errorType)),
        false,
    )
    writeMethod := types.NewFunc(token.NoPos, pkg, "Write", writeSig)
    writer := types.NewInterfaceType([]*types.Func{writeMethod}, nil)
    writer.Complete()

    // Reader 自己声明 Read，并嵌入已经完成的 Writer。
    readSig := types.NewSignatureType(
        nil, nil, nil,
        types.NewTuple(),
        types.NewTuple(types.NewVar(token.NoPos, pkg, "s", stringType),
            types.NewVar(token.NoPos, pkg, "err", errorType)),
        false,
    )
    readMethod := types.NewFunc(token.NoPos, pkg, "Read", readSig)
    reader := types.NewInterfaceType([]*types.Func{readMethod}, []types.Type{writer})
    reader.Complete()

    fmt.Println(reader.NumExplicitMethods()) // 1
    fmt.Println(reader.NumEmbeddeds())       // 1
    fmt.Println(reader.NumMethods())         // 2
}

这里的 writer 先完成，再作为 reader 的嵌入类型传入。NewInterfaceType 会接管传入的方法列表，并可能为缺少接收者的签名补齐必要信息；如果这些方法对象还要被别的类型复用，最好在调用前就明确它们的所有权关系。

调用 NewInterfaceType 只完成结构拼装

构造函数返回的是一个尚未完成的接口对象。此时可以把它继续作为其他类型的输入，但不要急着把它当成已经算好的方法集。真正需要查询完整方法时，应确保所有嵌入接口都已经定义，再调用 Complete()。

完成后，NumExplicitMethods() 只统计当前接口自己传入的显式方法，NumEmbeddeds() 统计嵌入类型数量，而 NumMethods() 统计合并后的总方法数。遍历总方法时使用 Method(i)，遍历只看当前接口声明的部分时使用 ExplicitMethod(i)。

用 Complete 固化方法集

Complete() 会计算接口的类型集和方法集，并返回接收者本身，因此可以写成 reader = reader.Complete()。它必须放在所有嵌入类型完成之后；如果嵌入类型仍处于搭建阶段，过早计算会让后续结果不符合预期。

另一个容易忽略的点是并发读取。官方文档建议在并发使用接口前显式调用 Complete()，因为完成后的接口类型才适合安全地被多个 goroutine 读取。这个调用应放在构造阶段的单线程路径中，而不是让多个 worker 竞争完成同一个对象。

处理重复方法与并发边界

接口不能包含重复的方法。显式方法和嵌入接口合并后产生重复方法时，Complete() 会触发 panic，所以生成器在组装输入时应提前按方法的唯一标识去重，尤其要关注同名但来自不同包的对象。

嵌入项也要满足接口语义：正常使用时应传入底层为接口的 types.Type。如果正在分阶段构造命名类型，NewInterfaceType 对尚未完成的定义不会替你完成验证，仍需要在类型定义完整后再调用 Complete()。

排查结果时，可以把 NumExplicitMethods、NumEmbeddeds 和 NumMethods 同时记录下来。前两个数字正确而总数不对，通常是嵌入接口还没有完成，或者方法签名使用了错误的包对象。

小结

types.NewInterfaceType 适合把静态分析过程中已经拆开的方法和嵌入接口重新组合起来。记住三步即可：用 NewFunc 准备显式方法，用 NewInterfaceType 拼装结构，等嵌入类型就绪后调用 Complete() 再读取完整方法集。这样既能保留显式声明与嵌入来源的区别，也能让后续的类型检查和代码生成拿到稳定结果。

参考：go/types.NewInterfaceType 官方文档。