Go标准库无全文检索能力，go doc仅支持精确符号匹配；可用bleve构建轻量索引，或用docfx+Lunr.js生成静态可搜索文档，避免过度使用ES等重型引擎。
Go 标准库本身不提供全文检索引擎，go doc 和 godoc（已弃用）仅支持符号查找和静态 HTML 生成，无法实现关键词高亮、相关性排序或模糊匹配等搜索引擎核心能力。
为什么不能直接用 go doc 做搜索
go doc 是命令行符号查询工具，本质是解析 AST 后按包/函数名精确匹配；它不建立倒排索引，不支持以下行为：
- 输入
"timeout"找到所有含该词的注释（如// context.WithTimeout） - 搜索
"json marshal"跨包命中json.Marshal和encoding/json包文档 - 对
func NewClient(...)的注释内容做分词与权重计算
强行封装 go doc -json 输出再做字符串扫描，会漏掉跨行注释、结构体字段说明、示例代码中的关键词，且性能随标准库膨胀线性下降。
轻量级方案：用 bleve 索引 Go 文档源码
真正可行的起点是把 $GOROOT/src 或本地模块的 .go 文件（含注释）喂给一个嵌入式搜索引擎。推荐 bleve —— 它纯 Go 实现、无 CGO 依赖、支持自定义分词器，且能直接索引结构化数据。
立即学习“go语言免费学习笔记（深入）”；
关键步骤：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
go list -json -deps std获取所有标准库包路径，再用go/parser提取每个*ast.File的Doc字段和Comments - 构造索引文档结构：
struct { Package string; Name string; Kind string; Doc string; Comments []string } - 注册中文/英文混合分词器（
segment+en-icu），避免将HTTPHandler拆成HTTP Handler错误切分 - 查询时用
bleve.NewQueryStringQuery("context AND timeout")，而非正则全文扫
注意：bleve 默认不索引字段长度超过 1024 的 Doc 内容，需显式调用 mapping.AddFieldMapping("Doc", "text").SetIncludeInAll(true) 并增大 analysis.Config.MaxFieldLength。
生产可用的替代思路：复用 docfx + Lunr.js 静态搜索
如果你的目标是给团队内部 Go SDK 生成可搜索的文档站（非 CLI 工具），更稳的路径是放弃从零写索引，转而用文档生成链路自带的搜索能力：
- 用
golang.org/x/tools/cmd/godoc（新版）或swag提取注释生成 JSON 结构 - 用
docfx将 JSON 转为静态 HTML，并启用内置的Lunr.js搜索（支持 typo-tolerant） - 部署时只需
nginx托管静态文件，无需后端服务
陷阱：docfx 默认只索引 /// <summary></summary> 这类 XML 注释，需提前用脚本把 Go 的 // 注释转换为兼容格式，或改用 mkdocs + material 主题（其 search 插件原生支持 Markdown 注释提取）。
别碰 elasticsearch 或 meilisearch 的 Go 文档场景
这些重型引擎在 Go 文档搜索里属于过度设计：
- 标准库共约 200 个包，总注释文本不到 5MB，
bleve内存占用 30MB 足够，ES 单节点常驻 500MB+ - Go 文档更新频率极低（每半年一次大版本），无需分布式分片或近实时索引
-
meilisearch的 typo correction 对io.Copy这类大小写敏感符号反而造成干扰（搜copy可能错配Copier）
真要上分布式，优先考虑用 bleve 的 scorch 存储引擎配合 raft 做多副本，而不是引入新语言栈。
最易被忽略的一点：Go 文档中大量使用反引号包裹代码（如 `os.Open`），任何分词器若未配置「保留反引号内字符」规则，就会把 Open 当作独立词索引，导致搜 os.Open 时无法精确召回 —— 必须在 analyzer 中预处理剔除或转义反引号块。
