需确保索引路径存在且可写，用os.MkdirAll创建并设权限；字段须显式配置Index(true)及对应analyzer；QueryStringQuery需注意字段名大小写和停用词；Index实例不并发安全，写入需加锁或用Batch。
bleve.New() 报 permission denied 怎么处理
直接调用 bleve.New() 创建索引却报 open /path/to/index: permission denied，不是代码写错了，是目录根本不存在或当前进程没写权限。Go 不会自动创建父级目录，也不会帮你改 chmod。
必须提前确保路径存在且可写：
- 用
os.MkdirAll("/abs/path/to/index", 0755)创建完整路径并设权限 - 绝对避免相对路径（如
"./index"），启动位置一变就失效；推荐用filepath.Join(os.Getenv("HOME"), "myapp", "index")或基于os.Executable()拼接 - Windows 下别硬写
"\index"，统一用filepath.Join()处理分隔符 - 如果目录已存在且想复用，该用
bleve.Open()，不是bleve.New()；后者对已有目录会报invalid index format
字段没搜出来？大概率是 IndexMapping 配错了
文档明明存进去了，SearchRequest 却总返回零条结果，90% 是字段没声明为可索引。Bleve 默认不索引任何字段，全靠 IndexMapping 显式配置。
常见踩坑点：
立即学习“go语言免费学习笔记（深入）”；
-
mapping.AddFieldMappingsFromStruct(&MyDoc{})只按json:"title"tag 做字段映射，但不会自动设Index(true)；得手动链式调用：field.IndexingOptions().Store(true).Index(true) - 文本字段光设
Index(true)不够，必须配analyzer，比如英文用analysis.AnalyzerName("en")，中文需先注册gojieba.Analyzer并在 mapping 中指定 - 数值或时间字段若误设为
text类型，numeric_range查询会静默失败——查不到也不报错 - 查询时用的字段名（如
"title:go"）必须和 mapping 中定义的字段名完全一致，大小写、下划线都不能错
QueryStringQuery 搜不出东西？语法和 analyzer 是关键
写 bleve.NewQueryStringQuery("title:go AND body:web") 却没结果，问题常出在语法解析或 analyzer 配置上。
注意这些细节：
-
QueryStringQuery对字段名敏感，默认不支持驼峰（Title≠title），字段名必须小写且与 mapping 严格匹配 -
AND/OR可能被 analyzer 当作停用词过滤掉；更稳的方式是用bleve.NewBooleanQuery()手动拼：boolq.AddMust(bleve.NewTermQuery("go")).AddMust(bleve.NewTermQuery("web")) - 模糊搜索别依赖
golang~这种后缀写法——它只对单个 term 生效，且默认编辑距离为 1；需要更高容错，得用bleve.NewFuzzyQuery("golang").SetFuzziness(2) - 短语搜索必须用
bleve.NewPhraseQuery([]string{"hello", "world"})；QueryStringQuery里的双引号（"hello world"）只是字面量匹配，不触发 phrase 分析逻辑
并发写入 panic: concurrent map read and map write 怎么避免
多个 goroutine 直接往同一个 Index 实例调 Index()，跑一阵就 crash，错误是 fatal error: concurrent map read and map write。
Bleve 的 Index 实例本身**不保证并发安全**，写入必须串行或加锁：
- 最简单：用
sync.RWMutex包一层，所有index.Index()调用前加mu.Lock()，结束后mu.Unlock() - 高频写入场景建议改用
index.Batch()：攒一批文档一起提交，减少锁竞争，也提升吞吐 - 读操作（
index.Search()）可以并发，但要注意SearchRequest本身不是并发安全的，别在多个 goroutine 里复用同一个实例 - 如果业务天然读多写少，也可以考虑“写时复制”思路：定期重建索引，运行中只读旧索引，新索引建好再原子切换
真正容易被忽略的是 mapping 和 analyzer 的耦合性——字段类型、分词器、查询方式三者必须对齐，漏掉任一环都会让搜索静默失效。调试时优先检查 index.Mapping() 输出，确认字段是否真被标记为 index:true 且绑定了正确 analyzer。
