go/ast Doc の確認

ast.go

package main

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

// Sample.
//go:hoge
type Sample struct {
	Field int // First.
}

// type (
type (
	// sample
	Sample2 struct {
		Field2 int
	}
)

func main() {
	var fs token.FileSet
	f, err := parser.ParseFile(&fs, "main.go", nil, parser.ParseComments)
	if err != nil {
		fmt.Printf("%s\n", err)
	}

	ast.Inspect(f, func(n ast.Node) bool {
		switch n := n.(type) {
		case *ast.GenDecl:
			if n.Doc != nil {
				for _, c := range n.Doc.List {
					fmt.Printf("%s %T %q\n", fs.PositionFor(n.Pos(), false), n, c.Text)
				}
			}
		case *ast.TypeSpec:
			if n.Doc != nil {
				for _, c := range n.Doc.List {
					fmt.Printf("%s %T %q\n", fs.PositionFor(n.Pos(), false), n, c.Text)
				}
			}
		case *ast.File:
		}
		return true
	})
}

output.txt

main.go:12:1 *ast.GenDecl "// Sample."
main.go:12:1 *ast.GenDecl "//go:hoge"
main.go:17:1 *ast.GenDecl "// type ("
main.go:19:2 *ast.TypeSpec "// sample"