ast.inspect需搭配正确fset、err检查和nil判断才能安全使用；parser.parsefile要求fset非nil、mode明确、src合法；ast仅提供语法结构，真实类型需go/types推导。
ast.Inspect 能快速上手静态分析，但不配 fset、不查 err、不判 nil，一跑就 panic 或结果为空——这不是工具问题，是上下文没搭对。
parser.ParseFile 为什么总返回 nil 或 panic
它不负责容错，所有异常都塞进 err，你跳过检查就等于把 nil 当 *ast.File 用：
-
fset必须是token.NewFileSet()创建的非nil值，否则所有node.Pos()返回 0，定位失效 - 文件名传空字符串
""可以，但若走磁盘读取，建议用绝对路径；若走内存解析（src非nil），它只是占位符，不校验存在性 -
mode不能为nil：要注释就加parser.ParseComments，要容忍语法错误继续解析就加parser.AllErrors -
src决定读取方式：传nil表示从文件路径加载；传字符串（如os.ReadFile结果）则必须非nil，否则解析器直接跳过
典型崩溃：panic: interface conversion: ast.Node is nil, not *ast.FuncDecl，基本等于你没写 if err != nil { log.Fatal(err) } 就直接访问了 file。
ast.Inspect 回调里怎么安全提取函数信息
别硬写递归，ast.Inspect 自动跳过 nil 子节点、处理字段顺序、支持中途退出，但类型断言和空值判断缺一不可：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 函数名在
f.Name.Name，不是f.Name——后者是*ast.Ident节点，未判空就取会崩 -
f.Type.Params和f.Type.Results可能为nil（比如func hello() {}），不是空切片，必须先判空再访问.List - 参数是
*ast.Field，名字在field.Names（[]*ast.Ident），匿名参数（如func(int)）该切片为空，取[0]必 panic -
f.Doc是函数上方的注释，但仅当mode包含parser.ParseComments才非nil；f.Comments是整个文件注释列表，不是函数专属
为什么光靠 AST 拿不到变量真实类型
go/ast 只管语法，不管语义。看到 *ast.Ident 时，它可能是变量、函数、常量、包别名，甚至未定义标识符——Obj 字段只告诉你“这是个 var”，不告诉你它是 *bytes.Buffer 还是 string：
- 真实类型推导必须用
golang.org/x/tools/go/packages+go/types，加载包并执行类型检查 - 别把
ast.Expr直接丢给reflect.TypeOf——它不是运行时值，reflect会 panic - 结构体 tag 解析可结合
reflect.StructTag，但前提是先用 AST 提取出field.Tag.Value（如"`json:\"name\"`"），再用strings.Trim清洗引号后传入
初学者最容易忽略的三件事
不是 API 不好用，是默认假设太强：
-
ast.Inspect回调里改node字段完全无效——AST 是只读副本，真要重写得用golang.org/x/tools/go/ast/astutil -
*ast.FuncDecl和*ast.FuncLit完全不同：前者是顶层声明，后者是闭包字面量；FuncLit.Name永远是nil，别拿它当函数名用 - 想查 “当前在哪个函数里”？
ast.Inspect不提供父节点或作用域信息，得自己维护栈，或者换ast.Walk+ 自定义Visitor
复杂点不在遍历逻辑本身，而在每一步的上下文校验和语义补全——AST 是骨架，go/types 是血肉，漏掉哪一层，分析结果都只是半截子。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
