应先判空再访问：funcDecl.Type.Params和Results可能为nil，须if funcDecl.Type.Params != nil才取.List；函数名取funcDecl.Name.Name；init函数名也为"init"；返回false可提前退出；AST节点只读，不可修改。
怎么用 ast.Inspect 安全遍历函数声明
直接调用 ast.Inspect 是最常用也最容易 panic 的方式。它不自动跳过 nil 字段，一碰 funcDecl.Type.Params.List 就崩，因为 Go 允许无参数函数（func hello() {}），此时 Params 是 nil，不是空切片。
- 必须先判空：
if funcDecl.Type.Params != nil才能访问.List；同理Results也要判 -
funcDecl.Name.Name == "init"表示是init函数，没有导出名，别当成普通函数处理 - 想提前退出（比如只找第一个
main），在回调里返回false；返回true才继续往下走 - 别在回调里改
node字段——AST 节点是只读副本，改了无效，还可能干扰遍历顺序
为什么不能手写递归遍历 AST
手写递归看似可控，实则漏节点高发。比如只遍历 FuncDecl.Type.Params，却忘了 FuncType.Results 也是 *ast.FieldList 类型；或忽略 GenDecl 里嵌套的 FuncLit（匿名函数）。
-
ast.Inspect内部已按 Go 语法规范完整覆盖所有字段路径，自动跳过nil子节点 - 它不会栈溢出——标准库做了迭代优化，不是纯递归
- 字段访问顺序与 AST 定义严格对齐（如先
FuncType.Func再FuncType.Params） - Go 新增节点类型（如
ast.TypeSpec.TypeParams）时，ast.Inspect自动兼容，手写 switch 必须人工补
解析源码时 parser.ParseFile 的 Mode 参数怎么设
90% 的问题出在没设对 Mode 参数——不是 AST 看不懂，而是关键信息根本没加载进来。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 要读注释，必须传
parser.ParseComments，否则file.Comments为空 - 想收集全部语法错误（而非遇到第一个就停），得加
parser.AllErrors -
token.FileSet必须传给ParseFile，否则所有Pos()/End()都是 0，fset.Position(pos)拿不到行号 - 第四个参数传
nil表示从文件路径加载；若要内存解析（比如从字符串读），需传源码内容 +parser.FromFile模式
什么时候该换用 inspector 而不是 ast.Inspect
当你需要对同一组 AST 做多次不同目的的遍历（比如先找未使用变量，再统计函数复杂度，再提取注释），ast.Inspect 就成了性能瓶颈——每次都要重新 DFS 整棵树。
立即学习“go语言免费学习笔记（深入）”；
-
golang.org/x/tools/go/ast/inspector初始化时一次性构建事件列表，后续遍历直接扫描索引，实测快 2.5 倍 - 初始化：用
inspector.New([]*ast.File{f1, f2})，不是单个文件 - 只查函数？传
[]ast.Node{(*ast.FuncDecl)(nil)}给Preorder，避免无谓节点访问 - 需要前后序逻辑（比如进函数时计数、出函数时汇总），用
Nodes方法，它比Preorder多一层控制粒度 -
inspector不兼容老版本 Go 工具链，Go 1.21+ 更稳；低于此版本建议 stick withast.Inspect
ast.Inspect 回调里拿不到“当前在哪个函数里”——你得自己维护一个栈，或者直接换用 ast.Walk + 自定义 Visitor。 
