Go AST解析接口方法签名教程

本文介绍如何利用 Go 标准库 go/ast 深度解析源码中的接口声明，准确识别 interface{} 类型及其所有方法名与签名，适用于代码生成、接口骨架自动生成等元编程场景。

本文介绍如何利用 Go 标准库 `go/ast` 深度解析源码中的接口声明，准确识别 `interface{}` 类型及其所有方法名与签名，适用于代码生成、接口骨架自动生成等元编程场景。

在 Go 的抽象语法树（AST）中，接口类型并非直接暴露为顶层节点，而是嵌套在 *ast.GenDecl → *ast.TypeSpec → *ast.InterfaceType 这一链式结构中。初学者常误以为 *ast.GenDecl 本身携带类型语义，实则其 Tok 字段需先校验为 token.TYPE，再逐层解包 Specs 中的 *ast.TypeSpec，最终通过类型断言获取 *ast.InterfaceType 才能访问方法列表。

以下是一个完整、健壮的解析示例：

package main

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

func main() {
    fset := token.NewFileSet()
    src := `package service

type ServiceInterface interface {
    Create(NewServiceRequest) (JsonResponse, error)
    Delete(DelServiceRequest) (JsonResponse, error)
}

type AnotherStruct struct {
    Field string
}`

    f, err := parser.ParseFile(fset, "service.go", src, 0)
    if err != nil {
        panic(err)
    }

    for _, decl := range f.Decls {
        gen, ok := decl.(*ast.GenDecl)
        if !ok || gen.Tok != token.TYPE {
            continue // 跳过非 type 声明（如 const/var）
        }

        for _, spec := range gen.Specs {
            ts, ok := spec.(*ast.TypeSpec)
            if !ok || ts.Name == nil {
                continue
            }

            if it, ok := ts.Type.(*ast.InterfaceType); ok {
                fmt.Printf("interface %q:\n", ts.Name.Name)
                if it.Methods != nil {
                    for _, field := range it.Methods.List {
                        if len(field.Names) == 0 {
                            // 匿名方法（嵌入其他接口），可选择跳过或递归解析
                            continue
                        }
                        methodName := field.Names[0].Name
                        // 可进一步解析 field.Type 获取完整签名（如 *ast.FuncType）
                        fmt.Printf("  - method %q\n", methodName)
                    }
                } else {
                    fmt.Println("  - empty interface")
                }
            }
        }
    }
}

关键要点说明：

• ✅ 必须校验 *ast.GenDecl.Tok == token.TYPE，否则 Specs 可能是 const 或 var 声明；
• ✅ *ast.TypeSpec.Type 是接口类型的真正载体，需断言为 *ast.InterfaceType；
• ✅ InterfaceType.Methods 是 *ast.FieldList，其 List 字段才是方法声明切片；
• ⚠️ 方法名可能为空（如嵌入 io.Reader），此时 field.Names 长度为 0，应做空值保护；
• ? 若需获取完整方法签名（参数/返回值类型），可对 field.Type 断言为 *ast.FuncType 并遍历 Params 和 Results。

该模式可无缝集成至 CLI 工具中，配合 golang.org/x/tools/go/packages 实现跨包接口扫描，为自动化服务骨架生成（如 gRPC server stub、mock 实现、HTTP handler 路由绑定）提供可靠 AST 基础。