bleve是Go本地全文检索唯一合理起点；需预建目录、正确选Open/New、显式配置mapping与中文分词器、串行写入并调Close落盘。
直接用 bleve 建本地索引，别手写倒排、别硬扫文件、更别碰 Elasticsearch——99% 的 Go 文件全文检索场景，bleve 是唯一合理起点。
bleve.New() 报 permission denied 或 invalid index format 怎么办
这不是代码写错了，是路径没准备好。Go 不会自动创建父目录，也不会帮你修权限。
- 调
bleve.New()前必须先os.MkdirAll("/path/to/index", 0755)，不能依赖相对路径（如"./index"） - 已有索引要复用？必须用
bleve.Open()，不是bleve.New()；后者对非空目录会报invalid index format - Windows 下路径拼接务必用
filepath.Join()，别硬写"\index"，否则在 CI 或跨平台时静默失败
文档存进去了但 Search 返回空结果的常见原因
bleve 默认不索引任何字段，也不报错，只默默忽略。你看到零结果，大概率是 mapping 没配对。
- 字段必须显式声明可索引：
field.Index(true).Store(true)，光有json:"title"标签没用 - 文本字段不配分词器（如
analyzer: "en"或中文的"jieba"），就只是把整段当一个 token 存，搜“go tutorial”永远找不到 - 字段名大小写敏感：
Title和title是两个字段；查询时写title:go却在 struct 里定义了json:"Title"，必然查不到 - 数值或时间字段误设为
text类型，后续做numeric_range查询会静默失败，不报错也不返回
中文搜不到关键词？分词器没注册或没绑定到字段
bleve 默认只认英文，对中文完全无感。不手动接入 gojieba 或 gse，中文就是一整块不可切分的乱码。
立即学习“go语言免费学习笔记（深入）”；
- 先
import github.com/gojieba/gse，再构造自定义 analyzer：&analysis.JiebaTokenizer{Seg: seg} - 注册 analyzer：
mapping.AddCustomAnalyzer("jieba", analyzer)，然后在字段映射中指定：titleField.Analyzer = "jieba" - 别跳过
mapping.DefaultAnalyzer = "jieba"—— 否则未显式配置的字段仍走英文分词，中文照样切不开 - 测试时用
bleve.NewMatchQuery("中文关键词")先确认索引写入和分词生效，再换QueryStringQuery
并发写入 panic: concurrent map read and map write 怎么避免
bleve.Index 实例本身**不是 goroutine 安全的**。多个协程同时调 index.Index()，不出几秒就 crash。
- 写入必须串行，或加
sync.Mutex保护；别指望靠 channel 缓冲就能绕过——底层 scorch 引擎的 segment merge 是阻塞操作 - 批量写入用
index.Batch()，比单条Index()快 5–10 倍，且天然规避并发冲突 - 如果业务允许延迟，把写入任务推到后台 goroutine + 定时
Batch()，比实时写更稳 - 搜索可以并发，
index.Search()是安全的；但写和写之间、写和 Close() 之间，必须同步
最常被忽略的一点：索引建完不 index.Close()，数据可能根本没落盘——尤其用默认的 scorch KV 存储时，重启后整个索引变空。这不是 bug，是设计使然。
