bleve是go文件全文检索唯一合理起点；需预建目录、正确选open/new、显式配置mapping与中文分词器、串行写入并调close落盘。
直接用 bleve 是当前最稳的路径，自研倒排索引只适合教学或极特殊嵌入场景；关键不是“能不能写”，而是“值不值得绕过 bleve 去处理分词配置、字段映射、并发写入、落盘保证这些已知坑”。
bleve.New() 报 permission denied 或 index format 错误
这不是代码逻辑问题，是路径和生命周期管理没到位。
- 必须提前调用
os.MkdirAll("/abs/path/to/index", 0755)，bleve.New()不创建父目录，也不改权限 - 绝对别用
"./index"这类相对路径——二进制启动位置一变就失效；推荐用filepath.Join(filepath.Dir(os.Args[0]), "index") - 已有索引要复用？必须用
bleve.Open()，不是bleve.New()；后者会强行覆盖格式，报invalid index format - Windows 下路径拼接统一用
filepath.Join()，硬写"\index"在 CI 或 Docker 里必挂
中文搜不到关键词的三个硬性条件
bleve 默认完全不支持中文分词，不配 analyzer 就等于没索引中文内容。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 必须显式注册中文分词器：比如用
github.com/gojieba/gse，初始化seg := gse.NewGse("")，再包装成analysis.CustomAnalyzer - 字段 mapping 必须指定该 analyzer：
mapping.AddFieldMapping("Content", "text").Analyzer("jieba")，光设Index(true)没用 - 索引文档时字段名必须和 mapping 里声明的**完全一致**（大小写敏感），
json:"content"和Content是两个字段 - 别信
AddFieldMappingsFromStruct()自动推断——它只看 struct tag，不会帮你加Analyzer或Store(true)
SearchRequest 返回空结果但无报错
这是最典型的配置静默失败，90% 出现在字段未启用索引或查询语法不匹配。
- 文本字段必须同时设
Index(true)和Store(true)，否则SearchRequest.Highlight拿不到原始内容做高亮 -
QueryStringQuery("title:go")中的title必须和 mapping 中定义的字段名一字不差；驼峰字段如Title要写成Title:go - 想用
AND/OR逻辑？确认你用的 analyzer 没把它们当停用词过滤掉；更可靠的是用bleve.NewBooleanQuery()手动组合子查询 - 短语搜索必须用
bleve.NewPhraseQuery()，QueryStringQuery(""go lang"")中的双引号只是字面量，不触发 phrase 分析
并发写入 panic: concurrent map read and map write
bleve 的 Index 实例**不是 goroutine 安全的**，多个协程直接调 index.Index() 必崩。
- 不要自己加
sync.Mutex包一层了事——锁粒度太粗，吞吐暴跌；正确做法是批量写入：index.Batch()+batch.Index() - 如果必须高频单条写入，用 channel + 单 goroutine 消费队列，避免锁竞争
- 索引关闭前务必调
index.Close()，尤其用 scorch 存储时，否则数据可能未落盘，重启即丢失 - 测试阶段用内存索引
bleve.NewMemOnly()可绕过 I/O 问题，但上线必须切回磁盘索引并验证 Close 行为
真正容易被忽略的点是：bleve 的分词、索引、查询三者必须使用同一套 analyzer 配置，且中文分词器初始化后不能复用 seg 实例跨 goroutine 调用——gse 的 Seg 实例本身也不是并发安全的。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
