bleve.new()报permission denied需先用os.mkdirall创建目录并设权限，避免相对路径；复用索引应改用bleve.open()；字段须显式设index(true)且文本配analyzer，查询字段名须与mapping严格一致。
bleve.New() 初始化时路径权限错误怎么处理
直接用 bleve.New() 创建索引却报 open /path/to/index: permission denied，不是代码写错了，是目录不存在或没写入权限。Go 不会自动创建父级目录，也不会帮你改 chmod。
- 必须提前确保路径存在且当前进程有写权限：
os.MkdirAll("/path/to/index", 0755) - 避免用相对路径（比如
"./index"），启动位置一变就失效；优先用绝对路径或基于os.Executable()拼接 - Windows 下路径分隔符别硬写
"\"，统一用filepath.Join() - 如果复用已有索引，注意
bleve.Open()才是正确打开方式，New()是从头建新索引，强行对已有目录调用会报invalid index format
IndexMapping 构建时字段类型配错导致搜索无结果
明明文档存进去了，SearchRequest 却总返回零条，大概率是字段没设成可搜索类型。bleve 默认不索引任何字段，全靠 IndexMapping 显式声明。
-
mapping.AddFieldMappingsFromStruct(&MyDoc{})看似省事，但只会按 struct tag（如json:"title"）映射，不会自动加searchable:true；得手动调field.IndexingOptions().Store(true).Index(true) - 文本字段必须用
analysis.AnalyzerName("en")或自定义 analyzer，光设Index:true不够；中文需额外集成gojieba并注册 analyzer - 数值、时间字段如果误设为
text类型，范围查询（numeric_range）会静默失败——查不到也不报错
SearchRequest.Query 用错类型导致语法无效
写 query := bleve.NewQueryStringQuery("title:go AND body:web") 却搜不出东西，不是关键词问题，是 QueryStringQuery 对字段名敏感，且默认不支持驼峰字段。
- 字段名必须和 mapping 中定义的完全一致（比如 mapping 里叫
"Title"，就不能在 query string 里写title:） - 想用
AND/OR，得确认 analyzer 没把它们当停用词过滤掉；更稳的方式是用bleve.NewBooleanQuery()拼接子查询 - 模糊搜索别依赖
~后缀（如golang~），它只对单个 term 生效，且默认编辑距离为 1；需要更高容错得配bleve.NewFuzzyQuery()并显式设Fuzziness - 短语搜索必须用
bleve.NewPhraseQuery()，QueryStringQuery里的双引号只是字面量匹配，不触发 phrase 分析
并发写入索引 panic: concurrent map read and map write
多个 goroutine 直接往同一个 Index 实例调 Index()，运行一阵就 crash，错误信息是 fatal error: concurrent map read and map write。bleve 的 Index 实例本身不是 goroutine-safe 的。
- 写操作必须串行：要么加
sync.Mutex包一层，要么用 channel 把写请求排队（推荐后者，避免阻塞主逻辑） - 读操作（
Search()）可以并发，但要注意：如果写操作正在执行Index.Batch()，而你同时调Search()，可能读到中间状态；生产环境建议搭配bleve.NewBatch()控制原子性 - 高频更新场景下，别反复调
index.Index(id, doc)，改用batch.Index()+index.Batch(batch)批量提交，性能提升明显且天然规避部分并发问题
bleve 本地索引没有内置事务或 WAL，写入中途崩溃可能导致索引损坏——所以别跳过 err != nil 检查，尤其在 Batch() 后。磁盘空间不足、inode 耗尽这些底层问题，bleve 只报 generic I/O error，得自己结合系统日志排查。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
