Go代码搜索引擎必须基于AST解析与类型检查构建符号图，而非全文索引；需用go list获取依赖、go/parser解析源码、go/types进行类型检查以准确处理作用域、接口实现等语义，结构化存储优于通用搜索引擎。
Go 代码搜索引擎不是靠全文索引通用文本那套逻辑就能跑起来的——它必须理解 Go 的语法结构、包依赖和符号作用域，否则搜 http.HandleFunc 会匹配到注释里的字符串，或根本找不到跨文件定义的接口实现。
用 go list + go/parser 构建准确的包级符号图
直接遍历 .go 文件并用正则找函数名？会漏掉类型别名展开、接口方法隐式实现、嵌套结构体字段等。正确起点是让 Go 工具链自己解析：
-
go list -json -deps ./...获取完整依赖树和每个包的GoFiles、Imports列表，避免手动处理 vendor 或 replace - 对每个包路径调用
go/parser.ParseDir，传入parser.ParseComments标志，保留 AST 中的CommentGroup—— 后续可支持 “搜函数文档中含 ‘timeout’ 的 handler” - 遍历 AST 的
*ast.FuncDecl、*ast.TypeSpec、*ast.Field节点，用ast.Inspect提取Ident.Name和其所在作用域位置（Ident.Pos()），别依赖func.Name.String()，它在泛型实例化后可能不是原始名
搜索时绕不开 types.Info：没有类型检查，就分不清同名不同义
只靠 AST 无法判断 err 是 error 类型变量，还是某个叫 err 的 struct 字段，更没法定位 io.ReadCloser 接口的实际实现位置。必须走一遍类型检查：
- 用
go/types.NewPackage和go/types.Config.Check对每个包做全量类型检查，耗时但不可省；跳过会导致SelectorExpr.X的类型为空，查不到方法接收者 - 从
types.Info.Selections中提取所有方法调用关系，构建 “方法 → 接收者类型 → 实现列表” 映射，这是支持 “找所有实现了Stringer的类型” 的唯一可靠方式 - 注意
types.Info.Defs中的键是ast.Node（如*ast.Ident），不是字符串名——相同名字在不同作用域是不同节点，直接按字符串聚合会误合并
避免用 elasticseach 或 bleve 直接索引源码
通用搜索引擎对 Go 代码友好度极低：不理解 func (r *Reader) Read(p []byte) (n int, err error) 里 n 是返回值而非参数，也无法识别 context.WithCancel 和 context.WithTimeout 属于同一包下的构造函数族。
立即学习“go语言免费学习笔记（深入）”；
- 如果非要引入外部索引，只存结构化数据：
pkgPath、symName、kind（func/type/var/const）、pos、doc（清理后的注释文本）、signature（格式化后的函数签名字符串） - 查询时先用结构化字段快速过滤（如
kind:func AND pkgPath:"net/http"），再对signature或doc做轻量级文本匹配，别让搜索引擎承担语义理解 - 本地开发场景下，用
map[string][]*Symbol内存索引 +strings.Contains就够快——Go 项目平均符号数在万级，冷启动解析一次，后续搜索毫秒级
gopls 的 References 和 Definition API 不是拿来即用的替代品
直接调 gopls 的 JSON-RPC 接口看似省事，但实际踩坑多：
-
gopls默认只索引打开的文件和其直接依赖，workspace/symbol搜不到未被引用的工具包函数；要全量需配"experimentalWorkspaceModule": true并重启 - 返回的位置是 LSP 协议格式（
{"uri":"file:///...","range":{...}}），转换成本地filepath+ 行号要小心URI编码和 Windows 路径分隔符 - 并发调用多个
textDocument/references请求容易触发gopls内部限流，错误信息是模糊的"context deadline exceeded"，不是网络超时而是服务端忙
真正难的不是解析或索引，是决定搜什么——用户输入 Read，该返回 io.Read 接口、os.File.Read 方法、还是所有含 Read 的标识符？这得结合调用上下文（比如光标前有 resp. 就优先方法），而上下文感知必须在编辑器插件层做，命令行工具只能保守返回全集。
