应优先使用 packages.Load 加载包，再用 parser.ParseFile（带 ParseComments）解析单文件；函数声明为 ast.FuncDecl，调用统一为 ast.CallExpr，需区分 ast.Ident 与 ast.SelectorExpr；推荐 ast.Inspect 遍历并用闭包维护上下文，但需注意其不跳过注释且无类型信息。
如何用 go/ast 加载并解析 Go 源文件
直接调用 parser.ParseFile 是最常用入口，但必须注意：它只解析单个文件，且默认不处理 //go:embed 或 //go:generate 等指令（这些属于 go/doc 或预处理器范畴）。若要扫描整个包，得先用 build.Default.Import 或 packages.Load 获取所有文件路径，再逐个解析。
常见错误是传入非 .go 文件或已编译的 .a 文件，会触发 parser.ErrInvalidSource；还有人误把目录路径传给 ParseFile，实际它只接受 filename string 和 src io.Reader 二选一。
- 推荐用
packages.Load（来自golang.org/x/tools/packages）统一加载，它自动处理go mod、//go:build标签和多文件包 -
ParseFile的mode参数建议至少带parser.ParseComments，否则注释节点（*ast.CommentGroup）为空 - 若只需语法结构不要类型信息，别开
parser.AllErrors——它会让解析器尽力继续，但可能返回残缺的 AST
遍历 AST 时怎么准确识别函数定义和调用
*ast.FuncDecl 表示函数声明，但要注意：它不包含方法接收者以外的“函数值”场景，比如 var f func(int) bool = … 是 *ast.AssignStmt + *ast.FuncLit；而 f(1) 这类调用统一落在 *ast.CallExpr 节点下。
关键陷阱在于：同一个函数名可能对应多种节点。例如 http.HandleFunc 中的 HandleFunc 是 *ast.SelectorExpr，而 fmt.Println 同理；但本地定义的 foo() 就是 *ast.Ident 直接作为 CallExpr.Fun。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 判断是否为「标准库函数调用」：检查
CallExpr.Fun是否为*ast.SelectorExpr，再看X是否为*ast.Ident且Name是"fmt"、"net/http"等 - 提取函数参数个数用
len(CallExpr.Args)，但注意...int展开后仍算一个*ast.Ellipsis节点，不是多个参数 - 别在
FuncDecl的Body外检查调用——顶层的CallExpr（如包级变量初始化里的）不在任何函数体内，需单独遍历
为什么 ast.Inspect 比递归遍历 ast.Walk 更实用
ast.Inspect 是函数式遍历，通过回调返回 bool 控制是否继续深入子树；而 ast.Walk 是 Visitor 模式，必须实现完整接口，写起来啰嗦且容易漏掉某些节点类型（比如忘记处理 *ast.CompositeLit）。
典型误用是以为 Inspect 会自动跳过注释或空白——它不会，所有节点都经过，包括 *ast.CommentGroup（哪怕 ParseFile 没开 ParseComments，只要源码里有注释行，AST 里就有该节点）。
- 想跳过某个子树？在回调里对目标节点返回
false，比如发现*ast.FuncLit就不进其Body - 需要上下文（如当前函数名）？用闭包捕获变量，别依赖节点字段反查——AST 不存父引用
- 性能敏感场景慎用
Inspect遍历全部节点：一个含 5000 行的文件可能生成上万节点，提前return能省 70%+ 时间
扫描结果不准？大概率是没处理 go:build 和类型别名
go/ast 解析器本身不执行条件编译，//go:build 或 // +build 标签只影响 packages.Load 是否包含某文件；而类型别名（type Foo = Bar）在 AST 中表现为 *ast.TypeSpec，但 Ident.Obj 为空，无法像普通类型那样查到底层定义。
这意味着：你扫到 var x Foo，用 ast.Inspect 只能拿到 Foo 这个标识符，但没法知道它等价于 Bar——除非自己维护一个映射表，或改用 golang.org/x/tools/go/types 做类型检查。
- 跨文件类型追踪基本不可行：AST 是纯语法树，没有作用域链或导入关系解析能力
- 若需识别「所有使用了
time.Duration的地方」，仅靠ast.Ident匹配Name == "Duration"会漏掉import t "time"; t.Duration这种别名用法 - 真正健壮的扫描工具（如
staticcheck）都基于types.Info，而非裸 AST——这点常被低估
