如何在 Go 中提取函数注释标记（如 @annotation）

作者：袖梨 2026-07-02

Go 语言本身不支持 Java 或 Python 那样的运行时注解（annotations），但可通过解析源码的 AST 获取函数前的文档注释行，进而提取以 @ 开头的自定义标记（如 @annotation1）。本文详解实现原理、完整示例及注意事项。

go 语言本身不支持 java 或 python 那样的运行时注解（annotations），但可通过解析源码的 ast 获取函数前的文档注释行，进而提取以 `@` 开头的自定义标记（如 `@annotation1`）。本文详解实现原理、完整示例及注意事项。

Go 语言原生没有注解（annotations）机制，也不提供类似 func.GetAnnotations() 的反射接口。这与 Java 的 @Override 或 Python 的 @decorator 有本质区别。Go 的设计哲学强调显式性与简洁性，因此将元数据表达主要交由两种方式承担：

结构体字段标签（struct tags）：通过 reflect.StructTag 在运行时读取，适用于序列化、校验等场景；
源码级文档注释（doc comments）：即 // 或 /* */ 形式的注释，位于声明上方，需借助 go/ast 包静态解析源文件获取。

你示例中 // @annotation1 这类标记属于后者——它们是源码注释的一部分，而非语言级语法元素。要提取它们，必须解析 Go 源文件的抽象语法树（AST），定位目标函数节点，并检查其 Doc 字段（即关联的 *ast.CommentGroup）。

以下是一个完整可运行的示例，用于从指定 .go 文件中提取某函数的所有 @xxx 标记：

package mainimport (    "fmt"    "go/ast"    "go/parser"    "go/token"    "regexp"    "strings")func extractAnnotations(filename, funcName string) ([]string, error) {    fset := token.NewFileSet()    node, err := parser.ParseFile(fset, filename, nil, parser.ParseComments)    if err != nil {        return nil, fmt.Errorf("parse file: %w", err)    }    var annotations []string    ast.Inspect(node, func(n ast.Node) bool {        if fn, ok := n.(*ast.FuncDecl); ok && fn.Name.Name == funcName {            if fn.Doc != nil {                for _, comment := range fn.Doc.List {                    // 提取形如 "// @annotation1" 中的 "@annotation1"                    re := regexp.MustCompile(`//s*@(S+)`)                    matches := re.FindStringSubmatch(comment.Text)                    if len(matches) > 0 {                        annotations = append(annotations, string(matches[1:]))                    }                }            }            return false // 找到即停止遍历        }        return true    })    return annotations, nil}func main() {    // 假设当前目录下有 example.go，其中定义了 func Tags()    annos, err := extractAnnotations("example.go", "Tags")    if err != nil {        panic(err)    }    fmt.Printf("Annotations for Tags(): %vn", annos) // 输出: [annotation1 annotation2]}

⚠️ 重要注意事项：