结论是：packages.load 返回空或 panic 的主因是 config.mode 未正确设置（如缺失 needname、needsyntax 或 needtypesinfo）及 config.dir 未指向有效 go 工作区根（如含 go.mod 的目录），尤其在跨模块、vendor 或非 gopath 环境下极易失败。
直接说结论：用 x/tools/go/packages 加载 Go 包不是调用一个函数就完事，关键在于正确设置 packages.Config 的 Mode 和 Dir，否则会返回空结果或 panic——尤其在跨模块、vendor 或非 GOPATH 环境下。
为什么 packages.Load 返回空 slice 或 nil？
最常见原因是没设对加载模式和工作目录。这个包默认只读取 package declarations（NeedName | NeedFiles），但如果你要分析 AST 或类型，必须显式加 NeedSyntax 或 NeedTypesInfo；同时，Config.Dir 必须指向一个有效的 Go 工作区根（比如含 go.mod 的目录），不能是任意子目录。
-
Mode至少要包含packages.NeedName，否则连包名都拿不到 - 想获取 AST？必须加
packages.NeedSyntax - 想查变量类型或调用关系？得加
packages.NeedTypesInfo（这会触发完整类型检查） -
Config.Env一般不用动，但若目标项目用了自定义GOPATH或GO111MODULE，就得传进去，否则可能找不到依赖
如何安全加载单个包路径（如 net/http）？
别直接传 "net/http" 给 packages.Load——它会被当作相对路径解析，容易失败。正确做法是用 "./..." 模式配合 Config.Dir 指向标准库源码所在位置，但更实际的是：让 go list 后端自动处理，只需确保 GOOS/GOARCH 环境一致，并用 packages.Load 的 "all" 模式 + Filter 过滤。
- 加载内置包推荐方式：
packages.Load(&packages.Config{Mode: packages.NeedName, Dir: "/tmp", Tests: false}, "net/http")—— 注意Dir只要是个合法路径即可，x/tools内部会委托go list - 若报错
no Go files in，大概率是Dir所在目录没go.mod且不在 GOPATH 下，此时可临时设Config.Env = append(os.Environ(), "GO111MODULE=off") - 避免硬编码路径，用
runtime.GOROOT()拼出标准库路径再加载，仅限调试；生产环境应依赖go list的自动发现
如何解析当前目录下的 main 包并打印所有函数名？
这是最典型的入门场景，但容易卡在 AST 遍历逻辑里。重点不是怎么写 visitor，而是确保 Package.Syntax 不为空——这取决于你是否设置了 NeedSyntax，以及源文件是否被成功读取（比如 build tags 导致跳过）。
cfg := &packages.Config{
Mode: packages.NeedName | packages.NeedSyntax | packages.NeedTypesInfo,
Dir: ".", // 必须是 go.mod 所在目录
}
pkgs, err := packages.Load(cfg, "./...")
if err != nil || len(pkgs) == 0 {
log.Fatal(err)
}
for _, pkg := range pkgs {
for _, f := range pkg.Syntax {
ast.Inspect(f, func(n ast.Node) bool {
if fn, ok := n.(*ast.FuncDecl); ok && fn.Name != nil {
fmt.Println(fn.Name.Name)
}
return true
})
}
}
-
pkg.Syntax是[]*ast.File，每个对应一个 .go 文件；如果为空，先检查pkg.Errors是否有 build constraint 错误 - 不要假设
pkg.Types一定可用——只有加了NeedTypesInfo且无编译错误时才有 -
./...会递归加载子目录，如果只想加载当前包，用"."即可
真正麻烦的从来不是 API 调用本身，而是 Go 构建约束、模块边界和 vendor 机制带来的隐式行为差异。比如 packages.NeedDeps 会让加载变慢数倍，但不加它，你就拿不到 pkg.Deps 列表；又比如 Tests: true 会把 _test.go 也拉进来，但若测试文件引用了未导出符号，类型检查就会失败——这些细节不会报错，只会静默丢数据。
