初始化索引路径错误会导致index.Close() panic，常见原因包括非法字符、权限不足或重复New未Close；中文搜索需注册gojieba分词器并设DefaultAnalyzer；QueryStringQuery需注意字段配置和语法；高频写入应调优scorch flush参数。
初始化索引时路径写错导致 index.Close() panic
常见错误是调用 bleve.New("myindex", mapping) 后，目录名含非法字符（如 ../、空格）、权限不足，或重复用同一路径多次 New 而未 Close —— 这会锁住文件，后续 Open 或再次 New 都可能 panic：「index is locked」。
- 实操建议始终用绝对路径或确保相对路径基于可预测工作目录（比如
filepath.Join("index", "articles.bleve")） - 首次启动优先用
bleve.Open()尝试打开已有索引；失败再 fallback 到bleve.New()创建新索引 - 务必在
defer index.Close()前确认index非 nil，否则 panic 会直接 crash 进程
中文搜索没结果？默认分词器不支持中文
bleve.NewIndexMapping() 返回的默认 mapping 只按空格/标点切词，对「Go Web 开发入门」能分出 Go、Web，但对「全文检索」只会当一个整词，搜「全文」或「检索」都匹配不到。
- 必须显式注册中文分词器，例如用
github.com/dutchcoders/gojieba： - 创建 mapping 前调用
gojieba.Analyzer.Register() - 在 mapping 中为字段指定分析器：
mapping.DefaultAnalyzer = "gojieba"，并确保字段开启索引（"index": true） - 注意：v2 版本中
gojieba需配合bleve/v2使用，bleve（无 /v2）已过时且不兼容
NewQueryStringQuery 的语法陷阱
NewQueryStringQuery("Go AND API") 看起来直观，但实际行为依赖 analyzer 和字段配置。如果 Title 字段没设 "include_in_all": true，而你只在 Body 字段索引了内容，那搜 Title:Go 就完全无效。
- 布尔操作符（
AND/OR）默认作用于all字段，不是所有字段自动参与 - 想限定字段，必须写成
Title:Go AND Body:API，且对应字段在 mapping 中已声明为可搜索 - 短语搜索要用双引号：
"RESTful API"，否则会被拆开成两个独立 term - 模糊搜索用波浪号：
Go~1表示编辑距离为 1，但需字段启用"analyzer": "keyword"或对应支持的 analyzer
高频写入下搜索延迟高？别忽略 scorch 的 flush 设置
Bleve 默认用 scorch 索引类型，它把变更先写内存 buffer，定期刷盘。若文档频繁 Index() 却不主动 Batch 或调 index.Flush()，新写入可能几秒后才可搜到。
立即学习“go语言免费学习笔记（深入）”；
- 开发期可加
index.SetErrorLog(log.New(os.Stderr, "[bleve] ", 0))观察 flush 日志 - 生产环境建议用
bleve.NewUsing("index/", mapping, config, "scorch")显式指定，并设置config["scorch"]["batch_size"] = 100和"flush_interval": "1s" - 单次写入量大时，改用
index.Batch()批量提交，比反复调Index()快 5–10 倍，也减少锁竞争
最常被忽略的是：mapping 一旦创建就不可变，改字段配置必须重建索引。上线前多跑一遍真实数据集测分词和查询逻辑，比上线后 debug 强十倍。
