使用go/ast编写静态分析工具的核心步骤包括：1.读取和解析go文件；2.遍历ast结构进行检查；3.构建命令行工具支持多文件扫描；4.注意性能、过滤测试文件、支持包级扫描及错误处理。第一步通过parser.parsefile方法将源文件转换为ast节点，并使用Token.fileset记录位置信息以便输出错误提示；第二步利用ast.walk函数配合自定义visitor实现规则检查，如检测函数是否缺少注释；第三步通过flag包接收文件参数并循环处理每个文件，封装检查逻辑于checkfile函数中；第四步在实际应用时应优化性能，如并发处理，忽略测试文件，采用packages包支持项目级扫描，并增强错误处理以应对不可解析文件。掌握这些要点即可快速实现一个实用的go静态分析工具。
在使用 Go 编写静态分析工具时，go/ast 包是一个非常实用的工具。它可以帮助我们解析 Go 源代码并构建抽象语法树（AST），从而实现对代码结构的理解和检查。如果你希望快速上手一个简单的静态检查工具，用 go/ast 是个不错的选择。
下面我会从几个实际操作角度出发，带你一步步了解如何用 go/ast 来实现一个简单的静态分析器。
如何读取和解析 Go 文件
第一步是把 Go 源文件读入内存，并通过 go/parser 解析成 AST 树。这一步的关键在于使用 parser.ParseFile 方法：
立即学习“go语言免费学习笔记（深入）”；
fset := token.NewFileSet() file, err := parser.ParseFile(fset, "example.go", nil, parser.AllErrors) if err != nil { log.Fatal(err) }
上面这段代码会读取 example.go 文件内容，并将其转换为 AST 节点。token.FileSet 用于记录源码的位置信息，便于后续输出错误提示等操作。
需要注意的是，如果文件路径不对或者内容有语法错误，都会导致解析失败，所以建议在开发阶段加上一些日志输出或错误处理逻辑。
遍历 AST 结构进行检查
有了 AST 后，下一步就是遍历它。Go 提供了 ast.Walk 函数，可以递归访问 AST 中的所有节点。我们可以定义一个自定义的 visitor 来实现特定的检查逻辑。
比如我们要检查是否所有函数都有注释：
var visitor struct{} ast.Walk(visitor, file)
visitor 的定义如下：
type commentVisitor struct{} func (v commentVisitor) Visit(node ast.Node) ast.Visitor { if fn, ok := node.(*ast.FuncDecl); ok { if fn.Doc == nil { fmt.Printf("function %s has no commentn", fn.Name.Name) } } return v }
这样，每次遇到函数声明节点时，就会判断是否有文档注释。这种模式非常适合用来做各种规则检查，比如变量命名、函数长度、参数数量等。
构建命令行工具，支持多个文件扫描
如果你想把这个分析器做成一个命令行工具，可以通过 flag 或 os.Args 接收输入文件列表，然后循环处理每个文件。
这里是一个简单的主函数框架：
func main() { flag.Parse() for _, filename := range flag.Args() { fset := token.NewFileSet() file, err := parser.ParseFile(fset, filename, nil, parser.AllErrors) if err != nil { log.Printf("parse error: %v", err) continue } // 执行检查逻辑 checkFile(file) } }
checkFile 可以是你封装好的检查函数，里面调用前面提到的 visitor 来遍历 AST 并输出结果。
另外，也可以考虑将检查结果格式化输出，比如 json 或者带行号的文本提示，这样更方便集成到 ide 或 CI 系统中。
实际应用中的注意事项
- 性能问题：对于大型项目，逐个解析文件可能比较慢，可以考虑并发处理。
- 忽略测试文件：通常不需要检查 _test.go 文件，可以在入口处加过滤。
- 支持包级扫描：除了单个文件，还可以使用 golang.org/x/tools/go/packages 支持整个包甚至项目的扫描。
- 错误处理要细致：有些文件可能无法解析成功，比如不完整的代码片段或非 Go 文件，要做好容错。
基本上就这些。用 go/ast 写一个静态检查工具并不复杂，但容易忽略细节，比如 AST 节点类型判断、位置信息获取等。只要掌握好 Visitor 模式和 AST 结构，就能写出很实用的小工具。
